@fystack/sdk 0.1.1 → 0.1.3

package/dist/index.esm.js

@@ -16,7 +16,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';
     }
@@ -40,7 +40,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')
         }
     };
 };
@@ -118,14 +119,63 @@ async function computeHMACForWebhook(apiSecret, event) {
     }
 }
 
-var WalletAddressType;
-(function(WalletAddressType) {
-    WalletAddressType["Evm"] = "evm";
-    WalletAddressType["Sol"] = "sol";
-})(WalletAddressType || (WalletAddressType = {}));
+// Wallets
+var WalletType;
+(function(WalletType) {
+    WalletType["Standard"] = "standard";
+    WalletType["MPC"] = "mpc";
+})(WalletType || (WalletType = {}));
+var WalletPurpose;
+(function(WalletPurpose) {
+    WalletPurpose["General"] = "general";
+    WalletPurpose["Gastank"] = "gas_tank";
+    WalletPurpose["Deployment"] = "deployment";
+    WalletPurpose["Custody"] = "custody";
+    WalletPurpose["User"] = "user";
+    WalletPurpose["Payment"] = "payment";
+})(WalletPurpose || (WalletPurpose = {}));
+var WalletCreationStatus;
+(function(WalletCreationStatus) {
+    WalletCreationStatus["Pending"] = "pending";
+    WalletCreationStatus["Success"] = "success";
+    WalletCreationStatus["Error"] = "error";
+})(WalletCreationStatus || (WalletCreationStatus = {}));
+var AddressType;
+(function(AddressType) {
+    AddressType["Evm"] = "evm";
+    AddressType["Solana"] = "sol";
+    AddressType["Tron"] = "tron";
+})(AddressType || (AddressType = {}));
+var DestinationType;
+(function(DestinationType) {
+    DestinationType["InternalWallet"] = "internal_wallet";
+    DestinationType["AddressBook"] = "address_book";
+})(DestinationType || (DestinationType = {}));
+var TxStatus;
+(function(TxStatus) {
+    TxStatus["Pending"] = "pending";
+    TxStatus["Completed"] = "completed";
+    TxStatus["Confirmed"] = "confirmed";
+    TxStatus["Failed"] = "failed";
+    TxStatus["PendingApproval"] = "pending_approval";
+    TxStatus["Rejected"] = "rejected";
+})(TxStatus || (TxStatus = {}));
+var TxApprovalStatus;
+(function(TxApprovalStatus) {
+    TxApprovalStatus["Pending"] = "pending";
+    TxApprovalStatus["Approved"] = "approved";
+    TxApprovalStatus["Rejected"] = "rejected";
+})(TxApprovalStatus || (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);
@@ -147,7 +197,7 @@ async function composeAPIHeaders(credentials, httpMethod, apiEndpoint, body = {}
     return headers;
 }
 class APIService {
-    async getWalletDetail(addressType = "evm", walletId) {
+    async getWalletDetail(addressType = AddressType.Evm, walletId) {
         const endpoint = this.API.endpoints.getWalletDetail(walletId);
         const headers = await composeAPIHeaders(this.credentials, 'GET', endpoint);
         console.info('headers', headers);
@@ -218,6 +268,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);
@@ -319,7 +379,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() {
@@ -380,47 +459,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';
-    }
-}
-var TxStatus;
-(function(TxStatus) {
-    TxStatus["Pending"] = "pending";
-    TxStatus["Completed"] = "completed";
-    TxStatus["Confirmed"] = "confirmed";
-    TxStatus["Failed"] = "failed";
-    TxStatus["PendingApproval"] = "pending_approval";
-    TxStatus["Rejected"] = "rejected";
-})(TxStatus || (TxStatus = {}));
-var TxApprovalStatus;
-(function(TxApprovalStatus) {
-    TxApprovalStatus["Pending"] = "pending";
-    TxApprovalStatus["Approved"] = "approved";
-    TxApprovalStatus["Rejected"] = "rejected";
-})(TxApprovalStatus || (TxApprovalStatus = {}));
-var WalletType;
-(function(WalletType) {
-    WalletType["Standard"] = "standard";
-    WalletType["MPC"] = "mpc";
-})(WalletType || (WalletType = {}));
-var WalletCreationStatus;
-(function(WalletCreationStatus) {
-    WalletCreationStatus["Pending"] = "pending";
-    WalletCreationStatus["Success"] = "success";
-    WalletCreationStatus["Error"] = "error";
-})(WalletCreationStatus || (WalletCreationStatus = {}));
-var AddressType;
-(function(AddressType) {
-    AddressType["Evm"] = "evm";
-    AddressType["Solana"] = "sol";
-})(AddressType || (AddressType = {}));
-
 class FystackSDK {
     log(message) {
         if (this.enableLogging) {
@@ -433,10 +471,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 = WalletType.Standard } = options;
+        const { name, walletType = WalletType.Standard, sweepTaskParams, walletPurpose, sweepTaskId } = options;
         const response = await this.apiService.createWallet({
             name,
-            walletType
+            walletType,
+            walletPurpose,
+            sweepTaskParams,
+            sweepTaskId
         });
         if (waitForCompletion && response.status === WalletCreationStatus.Pending) {
             return this.waitForWalletCreation(response.wallet_id);
@@ -499,6 +540,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 = Environment.Production, logger = false } = options;
         this.apiService = new APIService(credentials, environment);
@@ -506,6 +558,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 AbstractSigner {
     setWallet(walletId) {
         if (!walletId || walletId.trim() === '') {
@@ -526,10 +588,10 @@ class EtherSigner extends 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(WalletAddressType.Evm, this.walletDetail?.WalletID);
+        const detail = await this.APIService.getWalletDetail(AddressType.Evm, this.walletDetail?.WalletID);
         this.walletDetail = detail;
         if (detail?.Address) {
             // cache the address
@@ -787,10 +849,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(WalletAddressType.Sol, this.walletDetail?.WalletID);
+        const detail = await this.APIService.getWalletDetail(AddressType.Solana, this.walletDetail?.WalletID);
         this.walletDetail = detail;
         if (detail?.Address) {
             // cache the address
@@ -930,10 +992,11 @@ class SolanaSigner {
         }
     }
     constructor(credentials, environment, pollerOptions){
+        this.APICredentials = credentials;
         this.APIKey = credentials.apiKey;
         this.APIService = new APIService(credentials, environment);
         this.pollerOptions = pollerOptions;
     }
 }
 
-export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletAddressType, WalletCreationStatus, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };
+export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, DestinationType, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletCreationStatus, WalletPurpose, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformRescanTransactionParams, transformWalletDetail };

package/dist/index.mjs

@@ -16,7 +16,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';
     }
@@ -40,7 +40,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')
         }
     };
 };
@@ -118,14 +119,63 @@ async function computeHMACForWebhook(apiSecret, event) {
     }
 }
 
-var WalletAddressType;
-(function(WalletAddressType) {
-    WalletAddressType["Evm"] = "evm";
-    WalletAddressType["Sol"] = "sol";
-})(WalletAddressType || (WalletAddressType = {}));
+// Wallets
+var WalletType;
+(function(WalletType) {
+    WalletType["Standard"] = "standard";
+    WalletType["MPC"] = "mpc";
+})(WalletType || (WalletType = {}));
+var WalletPurpose;
+(function(WalletPurpose) {
+    WalletPurpose["General"] = "general";
+    WalletPurpose["Gastank"] = "gas_tank";
+    WalletPurpose["Deployment"] = "deployment";
+    WalletPurpose["Custody"] = "custody";
+    WalletPurpose["User"] = "user";
+    WalletPurpose["Payment"] = "payment";
+})(WalletPurpose || (WalletPurpose = {}));
+var WalletCreationStatus;
+(function(WalletCreationStatus) {
+    WalletCreationStatus["Pending"] = "pending";
+    WalletCreationStatus["Success"] = "success";
+    WalletCreationStatus["Error"] = "error";
+})(WalletCreationStatus || (WalletCreationStatus = {}));
+var AddressType;
+(function(AddressType) {
+    AddressType["Evm"] = "evm";
+    AddressType["Solana"] = "sol";
+    AddressType["Tron"] = "tron";
+})(AddressType || (AddressType = {}));
+var DestinationType;
+(function(DestinationType) {
+    DestinationType["InternalWallet"] = "internal_wallet";
+    DestinationType["AddressBook"] = "address_book";
+})(DestinationType || (DestinationType = {}));
+var TxStatus;
+(function(TxStatus) {
+    TxStatus["Pending"] = "pending";
+    TxStatus["Completed"] = "completed";
+    TxStatus["Confirmed"] = "confirmed";
+    TxStatus["Failed"] = "failed";
+    TxStatus["PendingApproval"] = "pending_approval";
+    TxStatus["Rejected"] = "rejected";
+})(TxStatus || (TxStatus = {}));
+var TxApprovalStatus;
+(function(TxApprovalStatus) {
+    TxApprovalStatus["Pending"] = "pending";
+    TxApprovalStatus["Approved"] = "approved";
+    TxApprovalStatus["Rejected"] = "rejected";
+})(TxApprovalStatus || (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);
@@ -147,7 +197,7 @@ async function composeAPIHeaders(credentials, httpMethod, apiEndpoint, body = {}
     return headers;
 }
 class APIService {
-    async getWalletDetail(addressType = "evm", walletId) {
+    async getWalletDetail(addressType = AddressType.Evm, walletId) {
         const endpoint = this.API.endpoints.getWalletDetail(walletId);
         const headers = await composeAPIHeaders(this.credentials, 'GET', endpoint);
         console.info('headers', headers);
@@ -218,6 +268,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);
@@ -319,7 +379,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() {
@@ -380,47 +459,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';
-    }
-}
-var TxStatus;
-(function(TxStatus) {
-    TxStatus["Pending"] = "pending";
-    TxStatus["Completed"] = "completed";
-    TxStatus["Confirmed"] = "confirmed";
-    TxStatus["Failed"] = "failed";
-    TxStatus["PendingApproval"] = "pending_approval";
-    TxStatus["Rejected"] = "rejected";
-})(TxStatus || (TxStatus = {}));
-var TxApprovalStatus;
-(function(TxApprovalStatus) {
-    TxApprovalStatus["Pending"] = "pending";
-    TxApprovalStatus["Approved"] = "approved";
-    TxApprovalStatus["Rejected"] = "rejected";
-})(TxApprovalStatus || (TxApprovalStatus = {}));
-var WalletType;
-(function(WalletType) {
-    WalletType["Standard"] = "standard";
-    WalletType["MPC"] = "mpc";
-})(WalletType || (WalletType = {}));
-var WalletCreationStatus;
-(function(WalletCreationStatus) {
-    WalletCreationStatus["Pending"] = "pending";
-    WalletCreationStatus["Success"] = "success";
-    WalletCreationStatus["Error"] = "error";
-})(WalletCreationStatus || (WalletCreationStatus = {}));
-var AddressType;
-(function(AddressType) {
-    AddressType["Evm"] = "evm";
-    AddressType["Solana"] = "sol";
-})(AddressType || (AddressType = {}));
-
 class FystackSDK {
     log(message) {
         if (this.enableLogging) {
@@ -433,10 +471,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 = WalletType.Standard } = options;
+        const { name, walletType = WalletType.Standard, sweepTaskParams, walletPurpose, sweepTaskId } = options;
         const response = await this.apiService.createWallet({
             name,
-            walletType
+            walletType,
+            walletPurpose,
+            sweepTaskParams,
+            sweepTaskId
         });
         if (waitForCompletion && response.status === WalletCreationStatus.Pending) {
             return this.waitForWalletCreation(response.wallet_id);
@@ -499,6 +540,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 = Environment.Production, logger = false } = options;
         this.apiService = new APIService(credentials, environment);
@@ -506,6 +558,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 AbstractSigner {
     setWallet(walletId) {
         if (!walletId || walletId.trim() === '') {
@@ -526,10 +588,10 @@ class EtherSigner extends 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(WalletAddressType.Evm, this.walletDetail?.WalletID);
+        const detail = await this.APIService.getWalletDetail(AddressType.Evm, this.walletDetail?.WalletID);
         this.walletDetail = detail;
         if (detail?.Address) {
             // cache the address
@@ -787,10 +849,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(WalletAddressType.Sol, this.walletDetail?.WalletID);
+        const detail = await this.APIService.getWalletDetail(AddressType.Solana, this.walletDetail?.WalletID);
         this.walletDetail = detail;
         if (detail?.Address) {
             // cache the address
@@ -930,10 +992,11 @@ class SolanaSigner {
         }
     }
     constructor(credentials, environment, pollerOptions){
+        this.APICredentials = credentials;
         this.APIKey = credentials.apiKey;
         this.APIService = new APIService(credentials, environment);
         this.pollerOptions = pollerOptions;
     }
 }
 
-export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletAddressType, WalletCreationStatus, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };
+export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, DestinationType, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletCreationStatus, WalletPurpose, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformRescanTransactionParams, transformWalletDetail };