@zebec-network/exchange-card-sdk 1.1.11 → 1.2.1

package/dist/constants.d.ts

@@ -2,6 +2,11 @@ export declare const CARD_API_URL: Record<"Production" | "Sandbox", string>;
 export declare const NEAR_RPC_URL: Record<"Production" | "Sandbox", string>;
 export declare const XRPL_RPC_URL: Record<"Production" | "Sandbox", string>;
 export declare const STELLAR_RPC_URL: Record<"Production" | "Sandbox", string>;
+export declare const XDB_RPC_URL: Record<"Production" | "Sandbox", string>;
+export declare const XDB_NETWORK: {
+    readonly PUBLIC: "LiveNet Global XDBChain Network ; November 2023";
+    readonly TESTNET: "Futurenet XDBChain Network ; October 2023";
+};
 export declare const STELLAR_USDC_ISSUER: {
     readonly Sandbox: "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5";
     readonly Production: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN";

package/dist/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PLATFORM_FEE = exports.COUNTRIES_WITH_CCA3 = exports.BITCOIN_ENDPOINTS = exports.STELLAR_USDC_ISSUER = exports.STELLAR_RPC_URL = exports.XRPL_RPC_URL = exports.NEAR_RPC_URL = exports.CARD_API_URL = void 0;
+exports.PLATFORM_FEE = exports.COUNTRIES_WITH_CCA3 = exports.BITCOIN_ENDPOINTS = exports.STELLAR_USDC_ISSUER = exports.XDB_NETWORK = exports.XDB_RPC_URL = exports.STELLAR_RPC_URL = exports.XRPL_RPC_URL = exports.NEAR_RPC_URL = exports.CARD_API_URL = void 0;
 exports.CARD_API_URL = {
     Production: "https://cex.card.zebec.io",
     Sandbox: "https://cex.card.zebec.io",
@@ -17,6 +17,14 @@ exports.STELLAR_RPC_URL = {
     Production: "https://horizon.stellar.org",
     Sandbox: "https://horizon-testnet.stellar.org",
 };
+exports.XDB_RPC_URL = {
+    Production: "https://horizon.livenet.xdbchain.com/",
+    Sandbox: "https://horizon.futurenet.xdbchain.com/",
+};
+exports.XDB_NETWORK = {
+    PUBLIC: "LiveNet Global XDBChain Network ; November 2023",
+    TESTNET: "Futurenet XDBChain Network ; October 2023",
+};
 // Add USDC asset constants
 exports.STELLAR_USDC_ISSUER = {
     Sandbox: "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",

package/dist/services/algorandService.d.ts

@@ -0,0 +1,67 @@
+import algosdk from "algosdk";
+import { AlgorandClient } from "@algorandfoundation/algokit-utils";
+import { APIConfig } from "../helpers/apiHelpers";
+import { Quote } from "../types";
+export interface TransferConfig {
+    amount: number | string;
+    note?: string;
+}
+export interface AlgorandWallet {
+    address: algosdk.Address;
+    signAndSendTransaction: (txn: algosdk.Transaction) => Promise<string>;
+}
+export declare class AlgorandService {
+    readonly wallet: AlgorandWallet;
+    readonly apiConfig: APIConfig;
+    readonly algodClient: algosdk.Algodv2;
+    readonly algorandClient: AlgorandClient;
+    private apiService;
+    constructor(wallet: AlgorandWallet, apiConfig: APIConfig, sdkOptions?: {
+        sandbox?: boolean;
+    });
+    /**
+     * Fetches a quote for Bitcoin transfer.
+     *
+     * @returns {Promise<Quote>} A promise that resolves to a Quote object.
+     */
+    fetchQuote(symbol?: string): Promise<Quote>;
+    /**
+     * Fetches the Bitcoin vault address.
+     *
+     * @returns {Promise<{ address: string }>} A promise that resolves to the vault address.
+     */
+    fetchVault(symbol?: string): Promise<{
+        address: string;
+        tag?: string;
+    }>;
+    /**
+     * Transfer Algorand currency from one wallet to another
+     * @param config Transfer configuration
+     * @returns Transaction ID if successful
+     */
+    transferAlgo(config: TransferConfig): Promise<string>;
+    /**
+     * Get account balance in Algos
+     * @param address Account address
+     * @returns Balance in ALGO
+     */
+    getAccountBalance(address: string | algosdk.Address): Promise<number>;
+    /**
+     * Get account balance in microAlgos (for internal calculations)
+     * @param address Account address
+     * @returns Balance in microAlgos
+     */
+    private getAccountBalanceInMicroAlgo;
+}
+/**
+ * Convert ALGO to microAlgos
+ * @param algos Amount in ALGO
+ * @returns Amount in microAlgos
+ */
+export declare function algoToMicroAlgo(algos: number | string): bigint;
+/**
+ * Convert microAlgos to ALGO
+ * @param microAlgos Amount in microAlgos
+ * @returns Amount in ALGO
+ */
+export declare function microAlgoToAlgo(microAlgos: number | bigint): number;

package/dist/services/algorandService.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlgorandService = void 0;
+exports.algoToMicroAlgo = algoToMicroAlgo;
+exports.microAlgoToAlgo = microAlgoToAlgo;
+const algosdk_1 = __importDefault(require("algosdk"));
+const bignumber_js_1 = require("bignumber.js");
+const algokit_utils_1 = require("@algorandfoundation/algokit-utils");
+const client_manager_1 = require("@algorandfoundation/algokit-utils/types/client-manager");
+const apiHelpers_1 = require("../helpers/apiHelpers");
+class AlgorandService {
+    wallet;
+    apiConfig;
+    algodClient;
+    algorandClient;
+    apiService;
+    constructor(wallet, apiConfig, sdkOptions) {
+        this.wallet = wallet;
+        this.apiConfig = apiConfig;
+        const network = sdkOptions?.sandbox ? "testnet" : "mainnet";
+        this.algodClient = client_manager_1.ClientManager.getAlgodClient(client_manager_1.ClientManager.getAlgoNodeConfig(network, "algod"));
+        this.algorandClient = algokit_utils_1.AlgorandClient.fromClients({
+            algod: this.algodClient,
+        });
+        this.apiService = new apiHelpers_1.ZebecCardAPIService(apiConfig, sdkOptions?.sandbox || false);
+    }
+    /**
+     * Fetches a quote for Bitcoin transfer.
+     *
+     * @returns {Promise<Quote>} A promise that resolves to a Quote object.
+     */
+    async fetchQuote(symbol = "ALGO") {
+        const res = await this.apiService.fetchQuote(symbol);
+        return res;
+    }
+    /**
+     * Fetches the Bitcoin vault address.
+     *
+     * @returns {Promise<{ address: string }>} A promise that resolves to the vault address.
+     */
+    async fetchVault(symbol = "ALGO") {
+        const data = await this.apiService.fetchVault(symbol);
+        return data;
+    }
+    /**
+     * Transfer Algorand currency from one wallet to another
+     * @param config Transfer configuration
+     * @returns Transaction ID if successful
+     */
+    async transferAlgo(config) {
+        try {
+            const parsedAmount = algoToMicroAlgo(config.amount);
+            // Check if sender has sufficient balance
+            const senderBalance = await this.getAccountBalanceInMicroAlgo(this.wallet.address);
+            const minBalance = algoToMicroAlgo(0.1); // Minimum account balance
+            if (senderBalance < parsedAmount + minBalance) {
+                throw new Error(`Insufficient balance. Need ${microAlgoToAlgo(parsedAmount + minBalance)} ALGO, have ${microAlgoToAlgo(senderBalance)} ALGO`);
+            }
+            const vault = await this.fetchVault("ALGO");
+            const recipientAddress = vault.address;
+            // Validate recipient address
+            if (!algosdk_1.default.isValidAddress(recipientAddress)) {
+                throw new Error("Invalid recipient address");
+            }
+            // Get suggested transaction parameters
+            const suggestedParams = await this.algodClient.getTransactionParams().do();
+            // Create payment transaction
+            const paymentTxn = algosdk_1.default.makePaymentTxnWithSuggestedParamsFromObject({
+                sender: this.wallet.address,
+                receiver: recipientAddress,
+                amount: parsedAmount,
+                note: config.note ? new Uint8Array(Buffer.from(config.note)) : undefined,
+                suggestedParams: suggestedParams,
+            });
+            // Sign the transaction
+            const txId = await this.wallet.signAndSendTransaction(paymentTxn);
+            return txId;
+        }
+        catch (error) {
+            console.error("Transfer failed:", error);
+            throw error;
+        }
+    }
+    /**
+     * Get account balance in Algos
+     * @param address Account address
+     * @returns Balance in ALGO
+     */
+    async getAccountBalance(address) {
+        const amount = await this.getAccountBalanceInMicroAlgo(address);
+        return microAlgoToAlgo(amount);
+    }
+    /**
+     * Get account balance in microAlgos (for internal calculations)
+     * @param address Account address
+     * @returns Balance in microAlgos
+     */
+    async getAccountBalanceInMicroAlgo(address) {
+        const accountInfo = await this.algodClient.accountInformation(address).do();
+        return accountInfo.amount;
+    }
+}
+exports.AlgorandService = AlgorandService;
+/**
+ * Convert ALGO to microAlgos
+ * @param algos Amount in ALGO
+ * @returns Amount in microAlgos
+ */
+function algoToMicroAlgo(algos) {
+    return BigInt((0, bignumber_js_1.BigNumber)(algos).times(1_000_000).toFixed(0));
+}
+/**
+ * Convert microAlgos to ALGO
+ * @param microAlgos Amount in microAlgos
+ * @returns Amount in ALGO
+ */
+function microAlgoToAlgo(microAlgos) {
+    return (0, bignumber_js_1.BigNumber)(microAlgos).div(1_000_000).toNumber();
+}

package/dist/services/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./stellarService";
 export * from "./xrplService";
 export * from "./nearService";
+export * from "./algorandService";
+export * from "./xdbService";

package/dist/services/index.js

@@ -18,3 +18,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./stellarService"), exports);
 __exportStar(require("./xrplService"), exports);
 __exportStar(require("./nearService"), exports);
+__exportStar(require("./algorandService"), exports);
+__exportStar(require("./xdbService"), exports);

package/dist/services/xdbService.d.ts

@@ -0,0 +1,64 @@
+import { Asset, Horizon } from "@stellar/stellar-sdk";
+import { APIConfig, ZebecCardAPIService } from "../helpers/apiHelpers";
+import { Quote } from "../types";
+export interface XDBWalletInterface {
+    address: string;
+    signTransaction: (txXdr: string) => Promise<string>;
+}
+export declare class XDBService {
+    readonly wallet: XDBWalletInterface;
+    readonly apiService: ZebecCardAPIService;
+    readonly server: Horizon.Server;
+    private readonly 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(wallet: XDBWalletInterface, apiConfig: APIConfig, sdkOptions?: {
+        sandbox?: boolean;
+        apiKey?: string;
+    });
+    /**
+     * Fetches a quote for the given amount.
+     *
+     * @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(symbol?: string): Promise<{
+        address: 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.
+     */
+    transferXDB(amount: 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.
+     */
+    getNativeBalance(wallet: string): Promise<string>;
+    /**
+     * Retrieves the balance of a specific token for the specified wallet.
+     *
+     * @param {string} wallet - The public key of the wallet to get the token balance for.
+     * @param {Asset} asset - The asset object representing the token.
+     * @returns {Promise<string>} - A promise that resolves to the balance of the token.
+     */
+    getTokenBalance(wallet: string, asset: Asset): Promise<string>;
+    getAsset(assetCode: string, assetIssuer: string): Asset;
+}

package/dist/services/xdbService.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XDBService = void 0;
+const stellar_sdk_1 = require("@stellar/stellar-sdk");
+const constants_1 = require("../constants");
+const apiHelpers_1 = require("../helpers/apiHelpers");
+class XDBService {
+    wallet;
+    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(wallet, apiConfig, sdkOptions) {
+        this.wallet = wallet;
+        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.XDB_RPC_URL.Sandbox : constants_1.XDB_RPC_URL.Production);
+        this.sandbox = sandbox;
+    }
+    /**
+     * Fetches a quote for the given amount.
+     *
+     * @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(symbol = "XDB") {
+        const data = await this.apiService.fetchVault(symbol);
+        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 transferXDB(amount) {
+        // Fetch deposit address
+        const vault = await this.fetchVault("XDB");
+        const recipientAddress = vault.address;
+        const tag = vault.tag || "0";
+        // Prepare transaction
+        const account = await this.server.loadAccount(this.wallet.address);
+        const fee = await this.server.fetchBaseFee();
+        const memo = stellar_sdk_1.Memo.id(tag);
+        // Check Wallet balance
+        const balance = await this.getNativeBalance(this.wallet.address);
+        if (Number(balance) < Number(amount)) {
+            throw new Error("Insufficient balance");
+        }
+        // Build and submit transaction
+        const transaction = new stellar_sdk_1.TransactionBuilder(account, {
+            fee: fee.toString(),
+            networkPassphrase: this.sandbox ? constants_1.XDB_NETWORK.TESTNET : constants_1.XDB_NETWORK.PUBLIC,
+        })
+            .addOperation(stellar_sdk_1.Operation.payment({
+            destination: recipientAddress,
+            asset: stellar_sdk_1.Asset.native(),
+            amount,
+        }))
+            .addMemo(memo)
+            .setTimeout(stellar_sdk_1.TimeoutInfinite)
+            .build();
+        // Sign the transaction
+        const signedTxXdr = await this.wallet.signTransaction(transaction.toXDR());
+        const tx = stellar_sdk_1.TransactionBuilder.fromXDR(signedTxXdr, this.sandbox ? constants_1.XDB_NETWORK.TESTNET : constants_1.XDB_NETWORK.PUBLIC);
+        let retries = 0;
+        const maxRetries = 5;
+        let delay = 1000;
+        while (retries < maxRetries) {
+            try {
+                const transactionResult = await this.server.submitTransaction(tx, {
+                    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 getNativeBalance(wallet) {
+        const account = await this.server.loadAccount(wallet);
+        const nativeBalance = account.balances.find((balance) => balance.asset_type === "native");
+        return nativeBalance ? nativeBalance.balance : "0";
+    }
+    /**
+     * Retrieves the balance of a specific token for the specified wallet.
+     *
+     * @param {string} wallet - The public key of the wallet to get the token balance for.
+     * @param {Asset} asset - The asset object representing the token.
+     * @returns {Promise<string>} - A promise that resolves to the balance of the token.
+     */
+    async getTokenBalance(wallet, asset) {
+        const account = await this.server.loadAccount(wallet);
+        try {
+            const balance = account.balances.find((b) => b.asset_type !== "native" &&
+                b.asset_type !== "liquidity_pool_shares" &&
+                b.asset_code === asset.getCode())?.balance || "0";
+            return balance;
+        }
+        catch (error) {
+            console.debug(`Error fetching ${asset.getCode()} balance:`, error);
+            return "0";
+        }
+    }
+    getAsset(assetCode, assetIssuer) {
+        return new stellar_sdk_1.Asset(assetCode, assetIssuer);
+    }
+}
+exports.XDBService = XDBService;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zebec-network/exchange-card-sdk",
-	"version": "1.1.11",
+	"version": "1.2.1",
 	"description": "An sdk for purchasing silver card in zebec",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -25,7 +25,7 @@
 		"@types/jsonwebtoken": "^9.0.7",
 		"@types/mocha": "^10.0.9",
 		"@types/node": "^22.7.9",
-		"dotenv": "^16.4.5",
+		"dotenv": "^17.2.0",
 		"mocha": "11.2.2",
 		"prettier": "^3.3.3",
 		"rimraf": "^6.0.1",
@@ -35,6 +35,7 @@
 		"typescript": "^5.6.3"
 	},
 	"dependencies": {
+		"@algorandfoundation/algokit-utils": "^9.1.1",
 		"@creit.tech/stellar-wallets-kit": "^1.7.1",
 		"@mempool/mempool.js": "^3.0.0",
 		"@near-js/crypto": "^2.0.1",
@@ -43,6 +44,7 @@
 		"@near-js/types": "^2.0.1",
 		"@near-js/utils": "^2.0.1",
 		"@stellar/stellar-sdk": "^13.1.0",
+		"algosdk": "^3.3.1",
 		"axios": "^1.7.7",
 		"bignumber.js": "^9.3.0",
 		"bitcoinjs-lib": "^6.1.7",