@fystack/sdk 0.1.1 → 0.1.3

package/dist/index.cjs

@@ -24,7 +24,7 @@ const getBaseURL = (env)=>{
         case "local":
             return 'http://localhost:8150';
         case "sandbox":
-            return 'https://apex.void.exchange';
+            return 'https://api-dev.fystack.io';
         case "production":
             return 'https://api.fystack.io';
     }
@@ -48,7 +48,8 @@ const createAPI = (env)=>{
             getTransactionStatus: (walletId, transactionId)=>withBaseURL(`/web3/transaction/${walletId}/${transactionId}`),
             getWalletCreationStatus: (walletId)=>withBaseURL(`/wallets/creation-status/${walletId}`),
             getWalletAssets: (walletId)=>withBaseURL(`/wallets/${walletId}/assets`),
-            getDepositAddress: (walletId, addressType)=>withBaseURL(`/wallets/${walletId}/deposit-address?address_type=${addressType}`)
+            getDepositAddress: (walletId, addressType)=>withBaseURL(`/wallets/${walletId}/deposit-address?address_type=${addressType}`),
+            rescanTransaction: ()=>withBaseURL('/networks/rescan-transaction')
         }
     };
 };
@@ -126,14 +127,63 @@ async function computeHMACForWebhook(apiSecret, event) {
     }
 }
 
-exports.WalletAddressType = void 0;
-(function(WalletAddressType) {
-    WalletAddressType["Evm"] = "evm";
-    WalletAddressType["Sol"] = "sol";
-})(exports.WalletAddressType || (exports.WalletAddressType = {}));
+// Wallets
+exports.WalletType = void 0;
+(function(WalletType) {
+    WalletType["Standard"] = "standard";
+    WalletType["MPC"] = "mpc";
+})(exports.WalletType || (exports.WalletType = {}));
+exports.WalletPurpose = void 0;
+(function(WalletPurpose) {
+    WalletPurpose["General"] = "general";
+    WalletPurpose["Gastank"] = "gas_tank";
+    WalletPurpose["Deployment"] = "deployment";
+    WalletPurpose["Custody"] = "custody";
+    WalletPurpose["User"] = "user";
+    WalletPurpose["Payment"] = "payment";
+})(exports.WalletPurpose || (exports.WalletPurpose = {}));
+exports.WalletCreationStatus = void 0;
+(function(WalletCreationStatus) {
+    WalletCreationStatus["Pending"] = "pending";
+    WalletCreationStatus["Success"] = "success";
+    WalletCreationStatus["Error"] = "error";
+})(exports.WalletCreationStatus || (exports.WalletCreationStatus = {}));
+exports.AddressType = void 0;
+(function(AddressType) {
+    AddressType["Evm"] = "evm";
+    AddressType["Solana"] = "sol";
+    AddressType["Tron"] = "tron";
+})(exports.AddressType || (exports.AddressType = {}));
+exports.DestinationType = void 0;
+(function(DestinationType) {
+    DestinationType["InternalWallet"] = "internal_wallet";
+    DestinationType["AddressBook"] = "address_book";
+})(exports.DestinationType || (exports.DestinationType = {}));
+exports.TxStatus = void 0;
+(function(TxStatus) {
+    TxStatus["Pending"] = "pending";
+    TxStatus["Completed"] = "completed";
+    TxStatus["Confirmed"] = "confirmed";
+    TxStatus["Failed"] = "failed";
+    TxStatus["PendingApproval"] = "pending_approval";
+    TxStatus["Rejected"] = "rejected";
+})(exports.TxStatus || (exports.TxStatus = {}));
+exports.TxApprovalStatus = void 0;
+(function(TxApprovalStatus) {
+    TxApprovalStatus["Pending"] = "pending";
+    TxApprovalStatus["Approved"] = "approved";
+    TxApprovalStatus["Rejected"] = "rejected";
+})(exports.TxApprovalStatus || (exports.TxApprovalStatus = {}));
+
 async function composeAPIHeaders(credentials, httpMethod, apiEndpoint, body = {}) {
     if (credentials.apiSecret == '') {
-        // If APISecret is not provided, fallback to cookie mode with no headers
+        // If APISecret is not provided, use authToken
+        if (credentials.authToken) {
+            return {
+                Authorization: credentials.authToken
+            };
+        }
+        // fallback to cookie mode with no headers
         return {};
     }
     const currentTimestampInSeconds = Math.floor(Date.now() / 1000);
@@ -155,7 +205,7 @@ async function composeAPIHeaders(credentials, httpMethod, apiEndpoint, body = {}
     return headers;
 }
 class APIService {
-    async getWalletDetail(addressType = "evm", walletId) {
+    async getWalletDetail(addressType = exports.AddressType.Evm, walletId) {
         const endpoint = this.API.endpoints.getWalletDetail(walletId);
         const headers = await composeAPIHeaders(this.credentials, 'GET', endpoint);
         console.info('headers', headers);
@@ -226,6 +276,16 @@ class APIService {
         const response = await get(endpoint, headers);
         return response.data;
     }
+    /**
+   * Rescans a transaction on a specific network
+   * @param params Transaction hash and network ID
+   * @returns API response
+   */ async rescanTransaction(params) {
+        const endpoint = this.API.endpoints.rescanTransaction();
+        const transformedParams = transformRescanTransactionParams(params);
+        const headers = await composeAPIHeaders(this.credentials, 'POST', endpoint, transformedParams);
+        await post(endpoint, transformedParams, headers);
+    }
     constructor(credentials, environment){
         this.credentials = credentials;
         this.Webhook = new WebhookService(credentials);
@@ -327,7 +387,26 @@ function transformWalletDetail(data) {
 function transformCreateWalletPayload(data) {
     return {
         name: data.name,
-        wallet_type: data.walletType
+        wallet_type: data.walletType,
+        ...data.walletPurpose !== undefined && {
+            wallet_purpose: data.walletPurpose
+        },
+        ...data.sweepTaskParams !== undefined && {
+            sweep_task_params: {
+                min_trigger_value_usd: data.sweepTaskParams?.minTriggerValueUsd,
+                destination_wallet_id: data.sweepTaskParams?.destinationWalletId,
+                destination_type: data.sweepTaskParams?.destinationType
+            }
+        },
+        ...data.sweepTaskId !== undefined && {
+            sweep_task_id: data.sweepTaskId
+        }
+    };
+}
+function transformRescanTransactionParams(data) {
+    return {
+        tx_hash: data.txHash,
+        network_id: data.networkId
     };
 }
 BigInt.prototype.toJSON = function() {
@@ -388,47 +467,6 @@ class StatusPoller {
     }
 }
 
-class TransactionError extends Error {
-    constructor(message, code, transactionId, originalError){
-        super(message);
-        this.code = code;
-        this.transactionId = transactionId;
-        this.originalError = originalError;
-        this.name = 'TransactionError';
-    }
-}
-exports.TxStatus = void 0;
-(function(TxStatus) {
-    TxStatus["Pending"] = "pending";
-    TxStatus["Completed"] = "completed";
-    TxStatus["Confirmed"] = "confirmed";
-    TxStatus["Failed"] = "failed";
-    TxStatus["PendingApproval"] = "pending_approval";
-    TxStatus["Rejected"] = "rejected";
-})(exports.TxStatus || (exports.TxStatus = {}));
-exports.TxApprovalStatus = void 0;
-(function(TxApprovalStatus) {
-    TxApprovalStatus["Pending"] = "pending";
-    TxApprovalStatus["Approved"] = "approved";
-    TxApprovalStatus["Rejected"] = "rejected";
-})(exports.TxApprovalStatus || (exports.TxApprovalStatus = {}));
-exports.WalletType = void 0;
-(function(WalletType) {
-    WalletType["Standard"] = "standard";
-    WalletType["MPC"] = "mpc";
-})(exports.WalletType || (exports.WalletType = {}));
-exports.WalletCreationStatus = void 0;
-(function(WalletCreationStatus) {
-    WalletCreationStatus["Pending"] = "pending";
-    WalletCreationStatus["Success"] = "success";
-    WalletCreationStatus["Error"] = "error";
-})(exports.WalletCreationStatus || (exports.WalletCreationStatus = {}));
-exports.AddressType = void 0;
-(function(AddressType) {
-    AddressType["Evm"] = "evm";
-    AddressType["Solana"] = "sol";
-})(exports.AddressType || (exports.AddressType = {}));
-
 class FystackSDK {
     log(message) {
         if (this.enableLogging) {
@@ -441,10 +479,13 @@ class FystackSDK {
    * @param waitForCompletion Whether to wait for the wallet creation to complete
    * @returns Promise with wallet ID and status
    */ async createWallet(options, waitForCompletion = true) {
-        const { name, walletType = exports.WalletType.Standard } = options;
+        const { name, walletType = exports.WalletType.Standard, sweepTaskParams, walletPurpose, sweepTaskId } = options;
         const response = await this.apiService.createWallet({
             name,
-            walletType
+            walletType,
+            walletPurpose,
+            sweepTaskParams,
+            sweepTaskId
         });
         if (waitForCompletion && response.status === exports.WalletCreationStatus.Pending) {
             return this.waitForWalletCreation(response.wallet_id);
@@ -507,6 +548,17 @@ class FystackSDK {
         const depositAddressInfo = await this.apiService.getDepositAddress(walletId, addressType);
         return depositAddressInfo;
     }
+    /**
+   * Rescans a transaction on a specific network
+   * @param params Transaction hash and network ID
+   * @returns Promise that resolves when the rescan is initiated
+   */ async rescanTransaction(params) {
+        validateUUID(params.networkId, 'networkId');
+        if (!params.txHash || params.txHash.trim() === '') {
+            throw new Error('Invalid transaction hash provided');
+        }
+        await this.apiService.rescanTransaction(params);
+    }
     constructor(options){
         const { credentials, environment = exports.Environment.Production, logger = false } = options;
         this.apiService = new APIService(credentials, environment);
@@ -514,6 +566,16 @@ class FystackSDK {
     }
 }
 
+class TransactionError extends Error {
+    constructor(message, code, transactionId, originalError){
+        super(message);
+        this.code = code;
+        this.transactionId = transactionId;
+        this.originalError = originalError;
+        this.name = 'TransactionError';
+    }
+}
+
 class EtherSigner extends ethers.AbstractSigner {
     setWallet(walletId) {
         if (!walletId || walletId.trim() === '') {
@@ -534,10 +596,10 @@ class EtherSigner extends ethers.AbstractSigner {
         if (this.address) {
             return this.address;
         }
-        if (!this.APICredentials.apiKey && !this.walletDetail.WalletID) {
+        if (!this.APICredentials.apiKey && !this.APICredentials.authToken && !this.walletDetail.WalletID) {
             throw new Error('Wallet detail not found, use setWallet(walletId) to set wallet first!');
         }
-        const detail = await this.APIService.getWalletDetail(exports.WalletAddressType.Evm, this.walletDetail?.WalletID);
+        const detail = await this.APIService.getWalletDetail(exports.AddressType.Evm, this.walletDetail?.WalletID);
         this.walletDetail = detail;
         if (detail?.Address) {
             // cache the address
@@ -795,10 +857,10 @@ class SolanaSigner {
         if (this.address) {
             return this.address;
         }
-        if (!this.APIKey && !this.walletDetail?.WalletID) {
+        if (!this.APICredentials.apiKey && !this.APICredentials.apiSecret && !this.walletDetail?.WalletID) {
             throw new Error('Wallet detail not found, use setWallet(walletId) to set wallet first!');
         }
-        const detail = await this.APIService.getWalletDetail(exports.WalletAddressType.Sol, this.walletDetail?.WalletID);
+        const detail = await this.APIService.getWalletDetail(exports.AddressType.Solana, this.walletDetail?.WalletID);
         this.walletDetail = detail;
         if (detail?.Address) {
             // cache the address
@@ -938,6 +1000,7 @@ class SolanaSigner {
         }
     }
     constructor(credentials, environment, pollerOptions){
+        this.APICredentials = credentials;
         this.APIKey = credentials.apiKey;
         this.APIService = new APIService(credentials, environment);
         this.pollerOptions = pollerOptions;
@@ -957,4 +1020,5 @@ exports.createAPI = createAPI;
 exports.get = get;
 exports.post = post;
 exports.transformCreateWalletPayload = transformCreateWalletPayload;
+exports.transformRescanTransactionParams = transformRescanTransactionParams;
 exports.transformWalletDetail = transformWalletDetail;