@fystack/sdk 0.1.2 → 0.1.4

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';
     }
@@ -37,6 +37,7 @@ const createAPI = (env)=>{
         endpoints: {
             signTransaction: (walletId)=>withBaseURL(`/web3/transaction/${walletId}/signRaw`),
             getWalletDetail: (walletId)=>walletId ? withBaseURL(`/web3/wallet-detail/${walletId}`) : withBaseURL('/web3/wallet-detail'),
+            getWallets: (workspaceId)=>withBaseURL(`/workspaces/${workspaceId}/wallets`),
             createWallet: ()=>withBaseURL('/wallets'),
             createCheckout: ()=>withBaseURL('/checkouts'),
             getCheckout: (checkoutId)=>withBaseURL(`/checkouts/${checkoutId}`),
@@ -48,7 +49,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,11 +128,60 @@ 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 = {}));
+exports.WalletRole = void 0;
+(function(WalletRole) {
+    WalletRole["Admin"] = "wallet_admin";
+    WalletRole["Signer"] = "wallet_signer";
+    WalletRole["Viewer"] = "wallet_viewer";
+})(exports.WalletRole || (exports.WalletRole = {}));
+
 async function composeAPIHeaders(credentials, httpMethod, apiEndpoint, body = {}) {
     if (credentials.apiSecret == '') {
         // If APISecret is not provided, use authToken
@@ -161,7 +212,13 @@ async function composeAPIHeaders(credentials, httpMethod, apiEndpoint, body = {}
     return headers;
 }
 class APIService {
-    async getWalletDetail(addressType = "evm", walletId) {
+    async getWallets(workspaceId) {
+        const endpoint = this.API.endpoints.getWallets(workspaceId);
+        const headers = await composeAPIHeaders(this.credentials, 'GET', endpoint);
+        const response = await get(endpoint, headers);
+        return response.data;
+    }
+    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);
@@ -232,6 +289,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);
@@ -333,7 +400,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() {
@@ -394,47 +480,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) {
@@ -447,10 +492,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);
@@ -458,6 +506,16 @@ class FystackSDK {
         return response;
     }
     /**
+   * Gets all wallets for the workspace
+   * @returns Promise with list of wallets
+   */ async getWallets() {
+        if (!this.workspaceId) {
+            throw new Error('Workspace ID is required. Please set workspaceId in the constructor.');
+        }
+        const wallets = await this.apiService.getWallets(this.workspaceId);
+        return wallets;
+    }
+    /**
    * Gets the current status of a wallet creation process
    * @param walletId The ID of the wallet being created
    * @returns Promise with wallet creation status details
@@ -513,10 +571,32 @@ 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;
+        const { credentials, workspaceId, environment = exports.Environment.Production, logger = false } = options;
         this.apiService = new APIService(credentials, environment);
         this.enableLogging = logger;
+        this.workspaceId = workspaceId;
+    }
+}
+
+class TransactionError extends Error {
+    constructor(message, code, transactionId, originalError){
+        super(message);
+        this.code = code;
+        this.transactionId = transactionId;
+        this.originalError = originalError;
+        this.name = 'TransactionError';
     }
 }
 
@@ -543,7 +623,7 @@ class EtherSigner extends ethers.AbstractSigner {
         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
@@ -607,6 +687,12 @@ class EtherSigner extends ethers.AbstractSigner {
     async signTransaction(tx) {
         const startTime = new Date();
         console.log(`[WalletSDK] Transaction started at: ${startTime.toLocaleString()}`);
+        if (!this.address) {
+            await this.getAddress();
+        }
+        if (!this.walletDetail) {
+            this.walletDetail = await this.APIService.getWalletDetail();
+        }
         // Replace any Addressable or ENS name with an address
         const { to, from } = await ethers.resolveProperties({
             to: tx.to ? ethers.resolveAddress(tx.to, this.provider) : undefined,
@@ -653,6 +739,9 @@ class EtherSigner extends ethers.AbstractSigner {
         if (!this.address) {
             await this.getAddress();
         }
+        if (!this.walletDetail) {
+            this.walletDetail = await this.APIService.getWalletDetail();
+        }
         checkProvider(this, 'sendTransaction');
         // Only populate if gas fees are not set
         const hasGasFees = tx.gasPrice != null || tx.maxFeePerGas != null && tx.maxPriorityFeePerGas != null;
@@ -804,7 +893,7 @@ class SolanaSigner {
         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
@@ -964,4 +1053,5 @@ exports.createAPI = createAPI;
 exports.get = get;
 exports.post = post;
 exports.transformCreateWalletPayload = transformCreateWalletPayload;
+exports.transformRescanTransactionParams = transformRescanTransactionParams;
 exports.transformWalletDetail = transformWalletDetail;