@zebec-network/exchange-card-sdk 1.1.0

package/dist/services/TonService.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZebecCardTONService = void 0;
+const constants_1 = require("../constants");
+const apiHelpers_1 = require("../helpers/apiHelpers");
+const tonweb_1 = __importDefault(require("tonweb"));
+async function formatPayload(message) {
+    const cell = new tonweb_1.default.boc.Cell();
+    cell.bits.writeUint(0, 32);
+    cell.bits.writeString(message);
+    const boc = await cell.toBoc();
+    return Buffer.from(boc).toString("base64");
+}
+async function bocToHash(boc) {
+    const cell = tonweb_1.default.boc.Cell.fromBoc(Buffer.from(boc, "base64").toString("hex"));
+    return Buffer.from(await cell[0].hash()).toString("hex");
+}
+class ZebecCardTONService {
+    signer;
+    apiService;
+    tonRPC;
+    tonweb;
+    sandbox;
+    /**
+     * Constructs an instance of the service.
+     *
+     * @param {Signer} signer - The signer which can be either a PolkadotJs Signer or a KeyringPair.
+     * @param {APIConfig} apiConfig - The configuration object for the API.
+     * @param sdkOptions - Optional configuration for the SDK.
+     */
+    constructor(signer, apiConfig, sdkOptions) {
+        this.signer = signer;
+        const sandbox = sdkOptions?.sandbox ? sdkOptions.sandbox : false;
+        this.apiService = new apiHelpers_1.ZebecCardAPIService(apiConfig, sandbox);
+        this.tonRPC = sandbox ? constants_1.TON_RPC_URL.Sandbox : constants_1.TON_RPC_URL.Production;
+        this.tonweb = new tonweb_1.default(new tonweb_1.default.HttpProvider(this.tonRPC, {
+            apiKey: sdkOptions?.apiKey ?? "2191825d6718d115f3caffa8f69de292dd55de3b8c62a61421e7887148a60d6c",
+        }));
+        this.sandbox = sandbox;
+    }
+    /**
+     * Fetches a quote for the given amount.
+     *
+     * @param {string | number} amount - The amount for which to fetch the quote.
+     * @returns {Promise<Quote>} A promise that resolves to a Quote object.
+     */
+    async fetchQuote() {
+        const res = await this.apiService.fetchQuote("TON");
+        return res;
+    }
+    /**
+     * Fetches the TAO Vault address.
+     *
+     * @returns {Promise<string>} A promise that resolves to the TAO Vault address.
+     */
+    async fetchVault() {
+        const data = await this.apiService.fetchVault("TON");
+        return data;
+    }
+    /**
+     * Purchases a card by transferring TAO tokens.
+     *
+     * @param params - The parameters required to purchase a card.
+     * @param params.walletAddress - The wallet address from which TAO tokens will be transferred.
+     * @param params.amount - The amount of TAO tokens to transfer.
+     * @returns A promise that resolves to transaction hash.
+     * @throws {Error} If there is not enough balance or if the transaction fails.
+     */
+    async transferTon(params) {
+        if (!this.signer.account?.walletStateInit ||
+            !this.signer.account?.publicKey ||
+            !this.signer.account?.address) {
+            throw new Error("Invalid wallet account");
+        }
+        // Fetch deposit address
+        const { depositVault: depositAddress, tag } = await this.fetchVault();
+        const walletAddress = new tonweb_1.default.utils.Address(this.signer.account.address).toString(true, true, false, this.sandbox);
+        // Calculate fees and total amount
+        const platform_fee = (params.amount * constants_1.PLATFORM_FEE) / 10000;
+        const totalAmount = Math.floor((params.amount + platform_fee) * 10 ** 9);
+        // Check Wallet balance
+        const balance = await this.tonweb.getBalance(walletAddress);
+        if (Number(balance) < totalAmount) {
+            throw new Error("Insufficient balance");
+        }
+        // Prepare transaction
+        const transaction = {
+            validUntil: Math.floor(Date.now() / 1000) + 60, // 60 sec
+            messages: [
+                {
+                    address: depositAddress,
+                    amount: totalAmount.toString(),
+                    payload: await formatPayload(tag || ""),
+                },
+            ],
+        };
+        // Sign and submit transaction
+        const result = await this.signer.sendTransaction(transaction);
+        const txHash = await bocToHash(result.boc);
+        let retries = 0;
+        const maxRetries = 5;
+        let delay = 1000;
+        while (retries < maxRetries) {
+            try {
+                return txHash;
+            }
+            catch (error) {
+                console.debug("error: ", error);
+                if (retries >= maxRetries) {
+                    throw error;
+                }
+                retries += 1;
+                console.debug(`Retrying in ${delay / 1000} seconds...`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                delay *= 2; // Exponential backoff
+            }
+        }
+        throw new Error("Max retries reached");
+    }
+    /**
+     * Retrieves the balance of the specified wallet.
+     *
+     * @param {string} wallet - The address of the wallet to get the balance for. If the address starts with "0:", it will be converted to a full address format.
+     * @returns {Promise<string>} - A promise that resolves to the balance of the wallet.
+     */
+    async getWalletBalance(wallet) {
+        let walletAddress = wallet;
+        if (wallet.startsWith("0:")) {
+            walletAddress = new tonweb_1.default.utils.Address(wallet).toString(true, true, false, this.sandbox);
+        }
+        return this.tonweb.utils.fromNano(await this.tonweb.getBalance(walletAddress));
+    }
+}
+exports.ZebecCardTONService = ZebecCardTONService;

package/dist/services/XdbService.d.ts

@@ -0,0 +1,58 @@
+import { APIConfig } from "../helpers/apiHelpers";
+import { Keypair } from "xdb-digitalbits-sdk";
+import { Quote } from "../types";
+export declare class ZebecXdbService {
+    readonly signer: Keypair;
+    private apiService;
+    private server;
+    private sandbox;
+    /**
+     * Constructs an instance of the service.
+     *
+     * @param {DigitalBitsSdk.Keypair} signer - The signer keypair for the DigitalBits wallet.
+     * @param {APIConfig} apiConfig - The configuration object for the API.
+     * @param sdkOptions - Optional configuration for the SDK.
+     */
+    constructor(signer: Keypair, apiConfig: APIConfig, sdkOptions?: {
+        sandbox?: boolean;
+        apiKey?: string;
+    });
+    /**
+     * Fetches a quote for the given amount.
+     *
+     * @param {string | number} amount - The amount for which to fetch the quote.
+     * @returns {Promise<Quote>} A promise that resolves to a Quote object.
+     */
+    fetchQuote(): Promise<Quote>;
+    /**
+     * Fetches the Vault address.
+     *
+     * @returns {Promise<string>} A promise that resolves to the Vault address.
+     */
+    fetchVault(): Promise<{
+        depositVault: string;
+        tag?: string;
+    }>;
+    /**
+     * Transfers XDB tokens for a card purchase.
+     *
+     * @param params - The parameters required for token transfer.
+     * @param params.amount - The amount of XDB tokens to transfer.
+     * @param params.depositAddress - The destination address to receive tokens.
+     * @param params.tag - Optional memo tag for the transaction.
+     * @returns A promise that resolves to the transaction hash.
+     * @throws {Error} If there is not enough balance or if the transaction fails.
+     */
+    transferXDB(params: {
+        amount: string;
+        depositAddress: string;
+        tag?: string;
+    }): Promise<string>;
+    /**
+     * Retrieves the balance of the specified wallet.
+     *
+     * @param {string} wallet - The public key of the wallet to get the balance for.
+     * @returns {Promise<string>} - A promise that resolves to the balance of the wallet.
+     */
+    getWalletBalance(wallet: string): Promise<string>;
+}

package/dist/services/XdbService.js

@@ -0,0 +1,140 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZebecXdbService = void 0;
+const constants_1 = require("../constants");
+const apiHelpers_1 = require("../helpers/apiHelpers");
+const xdb_digitalbits_sdk_1 = __importStar(require("xdb-digitalbits-sdk"));
+class ZebecXdbService {
+    signer;
+    apiService;
+    server;
+    sandbox;
+    /**
+     * Constructs an instance of the service.
+     *
+     * @param {DigitalBitsSdk.Keypair} signer - The signer keypair for the DigitalBits wallet.
+     * @param {APIConfig} apiConfig - The configuration object for the API.
+     * @param sdkOptions - Optional configuration for the SDK.
+     */
+    constructor(signer, apiConfig, sdkOptions) {
+        this.signer = signer;
+        const sandbox = sdkOptions?.sandbox ? sdkOptions.sandbox : false;
+        this.apiService = new apiHelpers_1.ZebecCardAPIService(apiConfig, sandbox);
+        this.server = new xdb_digitalbits_sdk_1.default.Server(sandbox ? constants_1.DIGITALBITS_RPC_URL.Sandbox : constants_1.DIGITALBITS_RPC_URL.Production);
+        this.sandbox = sandbox;
+    }
+    /**
+     * Fetches a quote for the given amount.
+     *
+     * @param {string | number} amount - The amount for which to fetch the quote.
+     * @returns {Promise<Quote>} A promise that resolves to a Quote object.
+     */
+    async fetchQuote() {
+        const res = await this.apiService.fetchQuote("XDB");
+        return res;
+    }
+    /**
+     * Fetches the Vault address.
+     *
+     * @returns {Promise<string>} A promise that resolves to the Vault address.
+     */
+    async fetchVault() {
+        const data = await this.apiService.fetchVault("XDB");
+        return data;
+    }
+    /**
+     * Transfers XDB tokens for a card purchase.
+     *
+     * @param params - The parameters required for token transfer.
+     * @param params.amount - The amount of XDB tokens to transfer.
+     * @param params.depositAddress - The destination address to receive tokens.
+     * @param params.tag - Optional memo tag for the transaction.
+     * @returns A promise that resolves to the transaction hash.
+     * @throws {Error} If there is not enough balance or if the transaction fails.
+     */
+    async transferXDB(params) {
+        // Prepare transaction
+        const account = await this.server.loadAccount(this.signer.publicKey());
+        const fee = await this.server.fetchBaseFee();
+        const memo = xdb_digitalbits_sdk_1.Memo.id(params.tag || "");
+        // Check Wallet balance
+        const balance = await this.getWalletBalance(this.signer.publicKey());
+        if (Number(balance) < Number(params.amount)) {
+            throw new Error("Insufficient balance");
+        }
+        // Build and submit transaction
+        const transaction = new xdb_digitalbits_sdk_1.default.TransactionBuilder(account, {
+            fee,
+            networkPassphrase: this.sandbox
+                ? xdb_digitalbits_sdk_1.default.Networks.TESTNET
+                : xdb_digitalbits_sdk_1.default.Networks.MAINNET,
+        })
+            .addOperation(xdb_digitalbits_sdk_1.default.Operation.payment({
+            destination: params.depositAddress,
+            asset: xdb_digitalbits_sdk_1.default.Asset.native(),
+            amount: params.amount,
+        }))
+            .addMemo(memo)
+            .setTimeout(xdb_digitalbits_sdk_1.TimeoutInfinite)
+            .build();
+        // Sign the transaction
+        transaction.sign(this.signer);
+        let retries = 0;
+        const maxRetries = 5;
+        let delay = 1000;
+        while (retries < maxRetries) {
+            try {
+                const transactionResult = await this.server.submitTransaction(transaction, {
+                    skipMemoRequiredCheck: false,
+                });
+                return transactionResult.hash;
+            }
+            catch (error) {
+                console.debug("error: ", error);
+                if (retries >= maxRetries) {
+                    throw error;
+                }
+                retries += 1;
+                console.debug(`Retrying in ${delay / 1000} seconds...`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                delay *= 2; // Exponential backoff
+            }
+        }
+        throw new Error("Max retries reached");
+    }
+    /**
+     * Retrieves the balance of the specified wallet.
+     *
+     * @param {string} wallet - The public key of the wallet to get the balance for.
+     * @returns {Promise<string>} - A promise that resolves to the balance of the wallet.
+     */
+    async getWalletBalance(wallet) {
+        const account = await this.server.loadAccount(wallet);
+        const nativeBalance = account.balances.find((balance) => balance.asset_type === "native");
+        return nativeBalance ? nativeBalance.balance : "0";
+    }
+}
+exports.ZebecXdbService = ZebecXdbService;

package/dist/services/stellarService.d.ts

@@ -0,0 +1,52 @@
+import { StellarWalletsKit } from "@creit.tech/stellar-wallets-kit";
+import { APIConfig } from "../helpers/apiHelpers";
+import { Quote } from "../types";
+export declare class StellarService {
+    readonly kit: StellarWalletsKit;
+    private apiService;
+    private server;
+    private sandbox;
+    /**
+     * Constructs an instance of the service.
+     *
+     * @param {DigitalBitsSdk.Keypair} signer - The signer keypair for the DigitalBits wallet.
+     * @param {APIConfig} apiConfig - The configuration object for the API.
+     * @param sdkOptions - Optional configuration for the SDK.
+     */
+    constructor(kit: StellarWalletsKit, apiConfig: APIConfig, sdkOptions?: {
+        sandbox?: boolean;
+        apiKey?: string;
+    });
+    /**
+     * Fetches a quote for the given amount.
+     *
+     * @param {string | number} amount - The amount for which to fetch the quote.
+     * @returns {Promise<Quote>} A promise that resolves to a Quote object.
+     */
+    fetchQuote(): Promise<Quote>;
+    /**
+     * Fetches the Vault address.
+     *
+     * @returns {Promise<string>} A promise that resolves to the Vault address.
+     */
+    fetchVault(): Promise<{
+        depositVault: string;
+        tag?: string;
+    }>;
+    /**
+     * Purchases a card by transferring XDB tokens.
+     *
+     * @param params - The parameters required to purchase a card.
+     * @returns A promise that resolves to an array containing the transaction details and the API response.
+     * @throws {InvalidEmailError} If the recipient's email address is invalid.
+     * @throws {Error} If the quote is invalid or expired, if there is not enough balance, or if the transaction fails.
+     */
+    transferXLM(amount: number): Promise<string>;
+    /**
+     * Retrieves the balance of the specified wallet.
+     *
+     * @param {string} wallet - The public key of the wallet to get the balance for.
+     * @returns {Promise<string>} - A promise that resolves to the balance of the wallet.
+     */
+    getWalletBalance(wallet: string): Promise<string>;
+}

package/dist/services/stellarService.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StellarService = void 0;
+const stellar_sdk_1 = require("@stellar/stellar-sdk");
+const constants_1 = require("../constants");
+const apiHelpers_1 = require("../helpers/apiHelpers");
+class StellarService {
+    kit;
+    apiService;
+    server;
+    sandbox;
+    /**
+     * Constructs an instance of the service.
+     *
+     * @param {DigitalBitsSdk.Keypair} signer - The signer keypair for the DigitalBits wallet.
+     * @param {APIConfig} apiConfig - The configuration object for the API.
+     * @param sdkOptions - Optional configuration for the SDK.
+     */
+    constructor(kit, apiConfig, sdkOptions) {
+        this.kit = kit;
+        const sandbox = sdkOptions?.sandbox ? sdkOptions.sandbox : false;
+        this.apiService = new apiHelpers_1.ZebecCardAPIService(apiConfig, sandbox);
+        this.server = new stellar_sdk_1.Horizon.Server(sandbox ? constants_1.STELLAR_RPC_URL.Sandbox : constants_1.STELLAR_RPC_URL.Production);
+        this.sandbox = sandbox;
+    }
+    /**
+     * Fetches a quote for the given amount.
+     *
+     * @param {string | number} amount - The amount for which to fetch the quote.
+     * @returns {Promise<Quote>} A promise that resolves to a Quote object.
+     */
+    async fetchQuote() {
+        const res = await this.apiService.fetchQuote("XLM");
+        return res;
+    }
+    /**
+     * Fetches the Vault address.
+     *
+     * @returns {Promise<string>} A promise that resolves to the Vault address.
+     */
+    async fetchVault() {
+        const data = await this.apiService.fetchVault("XLM");
+        return data;
+    }
+    /**
+     * Purchases a card by transferring XDB tokens.
+     *
+     * @param params - The parameters required to purchase a card.
+     * @returns A promise that resolves to an array containing the transaction details and the API response.
+     * @throws {InvalidEmailError} If the recipient's email address is invalid.
+     * @throws {Error} If the quote is invalid or expired, if there is not enough balance, or if the transaction fails.
+     */
+    async transferXLM(amount) {
+        // Fetch deposit address
+        const { depositVault: depositAddress, tag } = await this.fetchVault();
+        const accountAddress = await this.kit.getAddress();
+        // Prepare transaction
+        const account = await this.server.loadAccount(accountAddress.address);
+        const fee = await this.server.fetchBaseFee();
+        const platform_fee = (amount * constants_1.PLATFORM_FEE) / 10000;
+        const totalAmount = (amount + platform_fee).toString();
+        const memo = stellar_sdk_1.Memo.id(tag?.toString() || "");
+        // Check Wallet balance
+        const balance = await this.getWalletBalance(accountAddress.address);
+        if (Number(balance) < Number(totalAmount)) {
+            throw new Error("Insufficient balance");
+        }
+        // Build and submit transaction
+        const transaction = new stellar_sdk_1.TransactionBuilder(account, {
+            fee: fee.toString(),
+            networkPassphrase: this.sandbox ? stellar_sdk_1.Networks.TESTNET : stellar_sdk_1.Networks.PUBLIC,
+        })
+            .addOperation(stellar_sdk_1.Operation.payment({
+            destination: depositAddress,
+            asset: stellar_sdk_1.Asset.native(),
+            amount: totalAmount,
+        }))
+            .addMemo(memo)
+            .setTimeout(stellar_sdk_1.TimeoutInfinite)
+            .build();
+        // Sign the transaction
+        this.kit.signTransaction(transaction.toXDR());
+        let retries = 0;
+        const maxRetries = 5;
+        let delay = 1000;
+        while (retries < maxRetries) {
+            try {
+                const transactionResult = await this.server.submitTransaction(transaction, {
+                    skipMemoRequiredCheck: false,
+                });
+                const txHash = transactionResult.hash;
+                return txHash;
+            }
+            catch (error) {
+                console.debug("error: ", error);
+                if (retries >= maxRetries) {
+                    throw error;
+                }
+                retries += 1;
+                console.debug(`Retrying in ${delay / 1000} seconds...`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                delay *= 2; // Exponential backoff
+            }
+        }
+        throw new Error("Max retries reached");
+    }
+    /**
+     * Retrieves the balance of the specified wallet.
+     *
+     * @param {string} wallet - The public key of the wallet to get the balance for.
+     * @returns {Promise<string>} - A promise that resolves to the balance of the wallet.
+     */
+    async getWalletBalance(wallet) {
+        const account = await this.server.loadAccount(wallet);
+        const nativeBalance = account.balances.find((balance) => balance.asset_type === "native");
+        return nativeBalance ? nativeBalance.balance : "0";
+    }
+}
+exports.StellarService = StellarService;

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+import { SupportedChain } from "./chains";
+export declare class OrderCardRequest {
+    readonly amount: Money;
+    readonly recipient: Recipient;
+    readonly receipt: Receipt;
+    constructor(amount: Money, recipient: Recipient, receipt: Receipt);
+}
+export declare class Quote {
+    price: number;
+    fluctuationPercentage: number;
+    token: string;
+    constructor(price: number, // Total token amount needed for the USD purchase
+    fluctuationPercentage: number, // Amount of USD the user wants to purchase
+    token: string);
+}
+export declare class Deposit {
+    tokenName: string;
+    tokenAmount: number;
+    signature: string;
+    buyerAddress: string;
+    txHash?: string;
+    blockHash?: string;
+    chainId?: SupportedChain;
+    purchaseCounter?: number;
+    constructor(tokenName: string, tokenAmount: number, signature: string, buyerAddress: string, txHash?: string, blockHash?: string, chainId?: SupportedChain, purchaseCounter?: number);
+}
+export declare class Receipt {
+    quote?: Quote;
+    deposit?: Deposit;
+    constructor(quote?: Quote, deposit?: Deposit);
+}
+export declare class Money {
+    readonly amount: number;
+    readonly currencyCode: string;
+    private constructor();
+    static create(amount: number | string, currencyCode: string): Money;
+    static USD(amount: number | string): Money;
+}
+export declare class Recipient {
+    readonly participantId: string;
+    readonly firstName: string;
+    readonly lastName: string;
+    readonly emailAddress: string;
+    readonly address1: string;
+    readonly address2?: string;
+    readonly city: string;
+    readonly state: string;
+    readonly postalCode: string;
+    readonly countryCode: CountryCode;
+    readonly language: string;
+    readonly mobilePhone: string;
+    private constructor();
+    static create(participantId: string, firstName: string, lastName: string, emailAddress: string, mobilePhone: string, language: string, city: string, state: string, postalCode: string, countryCode: CountryCode, address1: string, address2?: string): Recipient;
+}
+export declare const allCountriesWithCode: {
+    name: string;
+    code: string;
+}[];
+export type CountryCode = "DZA" | "AGO" | "ARG" | "AUS" | "AUT" | "BEL" | "BOL" | "BRA" | "CMR" | "CAN" | "CHL" | "CRI" | "CYP" | "CZE" | "DNK" | "ECU" | "EGY" | "SLV" | "EST" | "FIN" | "FRA" | "GEO" | "DEU" | "GHA" | "GRC" | "GTM" | "HND" | "HUN" | "ISL" | "IRL" | "ITA" | "JAM" | "JPN" | "JOR" | "KEN" | "KOR" | "KWT" | "LTU" | "LUX" | "MWI" | "MYS" | "MLT" | "MEX" | "MAR" | "MOZ" | "NPL" | "NLD" | "NZL" | "NGA" | "NOR" | "OMN" | "PAK" | "PNG" | "PRY" | "PER" | "PHL" | "POL" | "PRT" | "PRI" | "QAT" | "ROU" | "SAU" | "SGP" | "SVK" | "SVN" | "ESP" | "SWE" | "TWN" | "THA" | "TTO" | "TUN" | "TUR" | "GBR" | "USA" | "URY" | "VUT" | "ZMB";