@fystack/sdk 0.1.8 → 0.1.10

package/dist/index.esm.js

@@ -42,7 +42,9 @@ const createAPI = (env)=>{
             getWalletCreationStatus: (walletId)=>withBaseURL(`/wallets/creation-status/${walletId}`),
             getWalletAssets: (walletId)=>withBaseURL(`/wallets/${walletId}/assets`),
             getDepositAddress: (walletId, addressType)=>withBaseURL(`/wallets/${walletId}/deposit-address?address_type=${addressType}`),
-            rescanTransaction: ()=>withBaseURL('/networks/rescan-transaction')
+            rescanTransaction: ()=>withBaseURL('/networks/rescan-transaction'),
+            requestWithdrawal: (walletId)=>withBaseURL(`/wallets/${walletId}/request-withdrawal`),
+            getWebhookPublicKey: (workspaceId)=>withBaseURL(`/workspaces/${workspaceId}/webhook-verification-key`)
         }
     };
 };
@@ -123,7 +125,7 @@ async function computeHMACForWebhook(apiSecret, event) {
 // Wallets
 var WalletType;
 (function(WalletType) {
-    WalletType["Standard"] = "standard";
+    WalletType["Hyper"] = "standard";
     WalletType["MPC"] = "mpc";
 })(WalletType || (WalletType = {}));
 var WalletPurpose;
@@ -173,6 +175,16 @@ var WalletRole;
     WalletRole["Signer"] = "wallet_signer";
     WalletRole["Viewer"] = "wallet_viewer";
 })(WalletRole || (WalletRole = {}));
+var WithdrawalStatus;
+(function(WithdrawalStatus) {
+    WithdrawalStatus["Pending"] = "pending";
+    WithdrawalStatus["PendingApproval"] = "pending_approval";
+    WithdrawalStatus["Approved"] = "approved";
+    WithdrawalStatus["Rejected"] = "rejected";
+    WithdrawalStatus["Processing"] = "processing";
+    WithdrawalStatus["Completed"] = "completed";
+    WithdrawalStatus["Failed"] = "failed";
+})(WithdrawalStatus || (WithdrawalStatus = {}));
 
 async function composeAPIHeaders(credentials, httpMethod, apiEndpoint, body = {}, headers) {
     if (!credentials.apiSecret || credentials.apiSecret === '') {
@@ -292,6 +304,28 @@ class APIService {
         const headers = await composeAPIHeaders(this.credentials, 'POST', endpoint, transformedParams);
         await post(endpoint, transformedParams, headers);
     }
+    /**
+   * Requests a withdrawal from a wallet
+   * @param walletId The wallet ID
+   * @param params Withdrawal parameters
+   * @returns Withdrawal response with auto_approved status and withdrawal details
+   */ async requestWithdrawal(walletId, params) {
+        const endpoint = this.API.endpoints.requestWithdrawal(walletId);
+        const transformedParams = transformRequestWithdrawalParams(params);
+        const headers = await composeAPIHeaders(this.credentials, 'POST', endpoint, transformedParams);
+        const response = await post(endpoint, transformedParams, headers);
+        return response.data;
+    }
+    /**
+   * Gets the webhook public key for a workspace
+   * @param workspaceId The workspace ID
+   * @returns Webhook public key response with base64 encoded ed25519 public key
+   */ async getWebhookPublicKey(workspaceId) {
+        const endpoint = this.API.endpoints.getWebhookPublicKey(workspaceId);
+        const headers = await composeAPIHeaders(this.credentials, 'GET', endpoint);
+        const response = await get(endpoint, headers);
+        return response.data;
+    }
     constructor(credentials, environment){
         this.credentials = credentials;
         this.Webhook = new WebhookService(credentials);
@@ -415,6 +449,19 @@ function transformRescanTransactionParams(data) {
         network_id: data.networkId
     };
 }
+function transformRequestWithdrawalParams(data) {
+    return {
+        asset_id: data.assetId,
+        amount: data.amount,
+        recipient_address: data.recipientAddress,
+        ...data.notes !== undefined && {
+            notes: data.notes
+        },
+        ...data.skipBalanceCheck !== undefined && {
+            skip_balance_check: data.skipBalanceCheck
+        }
+    };
+}
 BigInt.prototype.toJSON = function() {
     return this.toString();
 };
@@ -485,7 +532,7 @@ 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, sweepTaskParams, walletPurpose, sweepTaskId } = options;
+        const { name, walletType = WalletType.Hyper, sweepTaskParams, walletPurpose, sweepTaskId } = options;
         const response = await this.apiService.createWallet({
             name,
             walletType,
@@ -575,6 +622,41 @@ class FystackSDK {
         }
         await this.apiService.rescanTransaction(params);
     }
+    /**
+   * Requests a withdrawal from a wallet
+   * @param walletId The ID of the wallet to withdraw from
+   * @param params Withdrawal parameters including asset, amount, and recipient
+   * @returns Promise with withdrawal response including auto_approved status and withdrawal details
+   */ async requestWithdrawal(walletId, params) {
+        validateUUID(walletId, 'walletId');
+        validateUUID(params.assetId, 'assetId');
+        if (!params.amount || params.amount.trim() === '') {
+            throw new Error('Invalid amount provided');
+        }
+        if (!params.recipientAddress || params.recipientAddress.trim() === '') {
+            throw new Error('Invalid recipient address provided');
+        }
+        if (params.recipientAddress.length > 256) {
+            throw new Error('Recipient address exceeds maximum length of 256 characters');
+        }
+        if (params.notes && params.notes.length > 500) {
+            throw new Error('Notes exceed maximum length of 500 characters');
+        }
+        this.log(`Requesting withdrawal from wallet ${walletId}`);
+        const response = await this.apiService.requestWithdrawal(walletId, params);
+        this.log(`Withdrawal request completed, auto_approved: ${response.auto_approved}`);
+        return response;
+    }
+    /**
+   * Gets the webhook public key for a workspace
+   * @param workspaceId The workspace ID
+   * @returns Promise with webhook public key (base64 encoded ed25519 public key)
+   */ async getWebhookPublicKey(workspaceId) {
+        validateUUID(workspaceId, 'workspaceId');
+        this.log(`Getting webhook public key for workspace ${workspaceId}`);
+        const response = await this.apiService.getWebhookPublicKey(workspaceId);
+        return response;
+    }
     constructor(options){
         const { credentials, workspaceId, environment = Environment.Production, logger = false } = options;
         this.apiService = new APIService(credentials, environment);
@@ -1033,4 +1115,4 @@ class SolanaSigner {
     }
 }
 
-export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, DestinationType, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletCreationStatus, WalletPurpose, WalletRole, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformRescanTransactionParams, transformWalletDetail };
+export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, DestinationType, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletCreationStatus, WalletPurpose, WalletRole, WalletType, WebhookService, WithdrawalStatus, createAPI, get, post, transformCreateWalletPayload, transformRequestWithdrawalParams, transformRescanTransactionParams, transformWalletDetail };

package/dist/index.mjs

@@ -42,7 +42,9 @@ const createAPI = (env)=>{
             getWalletCreationStatus: (walletId)=>withBaseURL(`/wallets/creation-status/${walletId}`),
             getWalletAssets: (walletId)=>withBaseURL(`/wallets/${walletId}/assets`),
             getDepositAddress: (walletId, addressType)=>withBaseURL(`/wallets/${walletId}/deposit-address?address_type=${addressType}`),
-            rescanTransaction: ()=>withBaseURL('/networks/rescan-transaction')
+            rescanTransaction: ()=>withBaseURL('/networks/rescan-transaction'),
+            requestWithdrawal: (walletId)=>withBaseURL(`/wallets/${walletId}/request-withdrawal`),
+            getWebhookPublicKey: (workspaceId)=>withBaseURL(`/workspaces/${workspaceId}/webhook-verification-key`)
         }
     };
 };
@@ -123,7 +125,7 @@ async function computeHMACForWebhook(apiSecret, event) {
 // Wallets
 var WalletType;
 (function(WalletType) {
-    WalletType["Standard"] = "standard";
+    WalletType["Hyper"] = "standard";
     WalletType["MPC"] = "mpc";
 })(WalletType || (WalletType = {}));
 var WalletPurpose;
@@ -173,6 +175,16 @@ var WalletRole;
     WalletRole["Signer"] = "wallet_signer";
     WalletRole["Viewer"] = "wallet_viewer";
 })(WalletRole || (WalletRole = {}));
+var WithdrawalStatus;
+(function(WithdrawalStatus) {
+    WithdrawalStatus["Pending"] = "pending";
+    WithdrawalStatus["PendingApproval"] = "pending_approval";
+    WithdrawalStatus["Approved"] = "approved";
+    WithdrawalStatus["Rejected"] = "rejected";
+    WithdrawalStatus["Processing"] = "processing";
+    WithdrawalStatus["Completed"] = "completed";
+    WithdrawalStatus["Failed"] = "failed";
+})(WithdrawalStatus || (WithdrawalStatus = {}));
 
 async function composeAPIHeaders(credentials, httpMethod, apiEndpoint, body = {}, headers) {
     if (!credentials.apiSecret || credentials.apiSecret === '') {
@@ -292,6 +304,28 @@ class APIService {
         const headers = await composeAPIHeaders(this.credentials, 'POST', endpoint, transformedParams);
         await post(endpoint, transformedParams, headers);
     }
+    /**
+   * Requests a withdrawal from a wallet
+   * @param walletId The wallet ID
+   * @param params Withdrawal parameters
+   * @returns Withdrawal response with auto_approved status and withdrawal details
+   */ async requestWithdrawal(walletId, params) {
+        const endpoint = this.API.endpoints.requestWithdrawal(walletId);
+        const transformedParams = transformRequestWithdrawalParams(params);
+        const headers = await composeAPIHeaders(this.credentials, 'POST', endpoint, transformedParams);
+        const response = await post(endpoint, transformedParams, headers);
+        return response.data;
+    }
+    /**
+   * Gets the webhook public key for a workspace
+   * @param workspaceId The workspace ID
+   * @returns Webhook public key response with base64 encoded ed25519 public key
+   */ async getWebhookPublicKey(workspaceId) {
+        const endpoint = this.API.endpoints.getWebhookPublicKey(workspaceId);
+        const headers = await composeAPIHeaders(this.credentials, 'GET', endpoint);
+        const response = await get(endpoint, headers);
+        return response.data;
+    }
     constructor(credentials, environment){
         this.credentials = credentials;
         this.Webhook = new WebhookService(credentials);
@@ -415,6 +449,19 @@ function transformRescanTransactionParams(data) {
         network_id: data.networkId
     };
 }
+function transformRequestWithdrawalParams(data) {
+    return {
+        asset_id: data.assetId,
+        amount: data.amount,
+        recipient_address: data.recipientAddress,
+        ...data.notes !== undefined && {
+            notes: data.notes
+        },
+        ...data.skipBalanceCheck !== undefined && {
+            skip_balance_check: data.skipBalanceCheck
+        }
+    };
+}
 BigInt.prototype.toJSON = function() {
     return this.toString();
 };
@@ -485,7 +532,7 @@ 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, sweepTaskParams, walletPurpose, sweepTaskId } = options;
+        const { name, walletType = WalletType.Hyper, sweepTaskParams, walletPurpose, sweepTaskId } = options;
         const response = await this.apiService.createWallet({
             name,
             walletType,
@@ -575,6 +622,41 @@ class FystackSDK {
         }
         await this.apiService.rescanTransaction(params);
     }
+    /**
+   * Requests a withdrawal from a wallet
+   * @param walletId The ID of the wallet to withdraw from
+   * @param params Withdrawal parameters including asset, amount, and recipient
+   * @returns Promise with withdrawal response including auto_approved status and withdrawal details
+   */ async requestWithdrawal(walletId, params) {
+        validateUUID(walletId, 'walletId');
+        validateUUID(params.assetId, 'assetId');
+        if (!params.amount || params.amount.trim() === '') {
+            throw new Error('Invalid amount provided');
+        }
+        if (!params.recipientAddress || params.recipientAddress.trim() === '') {
+            throw new Error('Invalid recipient address provided');
+        }
+        if (params.recipientAddress.length > 256) {
+            throw new Error('Recipient address exceeds maximum length of 256 characters');
+        }
+        if (params.notes && params.notes.length > 500) {
+            throw new Error('Notes exceed maximum length of 500 characters');
+        }
+        this.log(`Requesting withdrawal from wallet ${walletId}`);
+        const response = await this.apiService.requestWithdrawal(walletId, params);
+        this.log(`Withdrawal request completed, auto_approved: ${response.auto_approved}`);
+        return response;
+    }
+    /**
+   * Gets the webhook public key for a workspace
+   * @param workspaceId The workspace ID
+   * @returns Promise with webhook public key (base64 encoded ed25519 public key)
+   */ async getWebhookPublicKey(workspaceId) {
+        validateUUID(workspaceId, 'workspaceId');
+        this.log(`Getting webhook public key for workspace ${workspaceId}`);
+        const response = await this.apiService.getWebhookPublicKey(workspaceId);
+        return response;
+    }
     constructor(options){
         const { credentials, workspaceId, environment = Environment.Production, logger = false } = options;
         this.apiService = new APIService(credentials, environment);
@@ -1033,4 +1115,4 @@ class SolanaSigner {
     }
 }
 
-export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, DestinationType, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletCreationStatus, WalletPurpose, WalletRole, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformRescanTransactionParams, transformWalletDetail };
+export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, DestinationType, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletCreationStatus, WalletPurpose, WalletRole, WalletType, WebhookService, WithdrawalStatus, createAPI, get, post, transformCreateWalletPayload, transformRequestWithdrawalParams, transformRescanTransactionParams, transformWalletDetail };

package/dist/types/index.d.ts

@@ -22,6 +22,8 @@ interface APIEndpoints {
     getWalletAssets: (walletId: string) => string;
     getDepositAddress: (walletId: string, addressType: string) => string;
     rescanTransaction: () => string;
+    requestWithdrawal: (walletId: string) => string;
+    getWebhookPublicKey: (workspaceId: string) => string;
 }
 interface APIConfig {
     baseURL: string;
@@ -276,7 +278,7 @@ interface GetCheckoutPaymentResponse {
 }
 
 declare enum WalletType {
-    Standard = "standard",
+    Hyper = "standard",
     MPC = "mpc"
 }
 declare enum WalletPurpose {
@@ -319,6 +321,15 @@ declare enum WalletRole {
     Signer = "wallet_signer",
     Viewer = "wallet_viewer"
 }
+declare enum WithdrawalStatus {
+    Pending = "pending",
+    PendingApproval = "pending_approval",
+    Approved = "approved",
+    Rejected = "rejected",
+    Processing = "processing",
+    Completed = "completed",
+    Failed = "failed"
+}
 
 interface APIResponse {
     data: any;
@@ -382,6 +393,19 @@ declare class APIService {
      * @returns API response
      */
     rescanTransaction(params: RescanTransactionParams): Promise<void>;
+    /**
+     * Requests a withdrawal from a wallet
+     * @param walletId The wallet ID
+     * @param params Withdrawal parameters
+     * @returns Withdrawal response with auto_approved status and withdrawal details
+     */
+    requestWithdrawal(walletId: string, params: RequestWithdrawalParams): Promise<RequestWithdrawalResponse>;
+    /**
+     * Gets the webhook public key for a workspace
+     * @param workspaceId The workspace ID
+     * @returns Webhook public key response with base64 encoded ed25519 public key
+     */
+    getWebhookPublicKey(workspaceId: string): Promise<WebhookPublicKeyResponse>;
 }
 declare class PaymentService {
     private apiKey;
@@ -415,6 +439,13 @@ declare function transformRescanTransactionParams(data: RescanTransactionParams)
     tx_hash: string;
     network_id: string;
 };
+declare function transformRequestWithdrawalParams(data: RequestWithdrawalParams): {
+    skip_balance_check?: boolean | undefined;
+    notes?: string | undefined;
+    asset_id: string;
+    amount: string;
+    recipient_address: string;
+};
 
 declare class TransactionError extends Error {
     readonly code: string;
@@ -555,6 +586,57 @@ interface WalletByWorkspaceResponse {
     top_assets: TopAssets[];
     wallet_purpose: string;
 }
+interface RequestWithdrawalParams {
+    assetId: string;
+    amount: string;
+    recipientAddress: string;
+    notes?: string;
+    skipBalanceCheck?: boolean;
+}
+interface WithdrawalApproval {
+    id: string;
+    user_id: string;
+    status: string;
+    created_at: string;
+    updated_at: string;
+}
+interface WithdrawalTransaction {
+    id: string;
+    hash?: string;
+    status: string;
+    created_at: string;
+    updated_at: string;
+}
+interface TxCategory {
+    id: string;
+    name: string;
+}
+interface Withdrawal {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    amount: string;
+    status: WithdrawalStatus;
+    recipient_address: string;
+    notes?: string;
+    withdrawal_approvals: WithdrawalApproval[];
+    creator_id: string;
+    asset_id: string;
+    asset?: WalletAssetDetail;
+    wallet_id: string;
+    transaction_id?: string;
+    transaction?: WithdrawalTransaction;
+    asset_hold_id: string;
+    error_reason?: string;
+    categories?: TxCategory[];
+}
+interface RequestWithdrawalResponse {
+    auto_approved: boolean;
+    withdrawal: Withdrawal;
+}
+interface WebhookPublicKeyResponse {
+    public_key: string;
+}
 
 interface SDKOptions {
     credentials: APICredentials;
@@ -611,6 +693,19 @@ declare class FystackSDK {
      * @returns Promise that resolves when the rescan is initiated
      */
     rescanTransaction(params: RescanTransactionParams): Promise<void>;
+    /**
+     * Requests a withdrawal from a wallet
+     * @param walletId The ID of the wallet to withdraw from
+     * @param params Withdrawal parameters including asset, amount, and recipient
+     * @returns Promise with withdrawal response including auto_approved status and withdrawal details
+     */
+    requestWithdrawal(walletId: string, params: RequestWithdrawalParams): Promise<RequestWithdrawalResponse>;
+    /**
+     * Gets the webhook public key for a workspace
+     * @param workspaceId The workspace ID
+     * @returns Promise with webhook public key (base64 encoded ed25519 public key)
+     */
+    getWebhookPublicKey(workspaceId: string): Promise<WebhookPublicKeyResponse>;
 }
 
 interface StatusPollerOptions {
@@ -708,4 +803,4 @@ declare class SolanaSigner {
     private incorporateSignatureIntoTransaction;
 }
 
-export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, DestinationType, Environment, EtherSigner, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type RescanTransactionParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, type SweepTaskParams, type TopAssets, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, type WalletByWorkspaceResponse, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletPurpose, type WalletResponse, WalletRole, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformRescanTransactionParams, transformWalletDetail };
+export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, DestinationType, Environment, EtherSigner, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type RequestWithdrawalParams, type RequestWithdrawalResponse, type RescanTransactionParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, type SweepTaskParams, type TopAssets, TransactionError, type TransactionStatusResponse, TxApprovalStatus, type TxCategory, TxStatus, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, type WalletByWorkspaceResponse, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletPurpose, type WalletResponse, WalletRole, WalletType, type WebhookEvent, type WebhookPublicKeyResponse, WebhookService, type Withdrawal, type WithdrawalApproval, WithdrawalStatus, type WithdrawalTransaction, createAPI, get, post, transformCreateWalletPayload, transformRequestWithdrawalParams, transformRescanTransactionParams, transformWalletDetail };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fystack/sdk",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Wallet SDK",
   "main": "dist/index.cjs",
   "types": "dist/types/index.d.ts",

package/src/api.ts

@@ -13,7 +13,10 @@ import {
   WalletAsset,
   DepositAddressResponse,
   RescanTransactionParams,
-  WalletByWorkspaceResponse
+  WalletByWorkspaceResponse,
+  RequestWithdrawalParams,
+  RequestWithdrawalResponse,
+  WebhookPublicKeyResponse
 } from './types'
 import {
   CreateCheckoutPayload,
@@ -232,6 +235,35 @@ export class APIService {
     const headers = await composeAPIHeaders(this.credentials, 'POST', endpoint, transformedParams)
     await post(endpoint, transformedParams, headers)
   }
+
+  /**
+   * Requests a withdrawal from a wallet
+   * @param walletId The wallet ID
+   * @param params Withdrawal parameters
+   * @returns Withdrawal response with auto_approved status and withdrawal details
+   */
+  async requestWithdrawal(
+    walletId: string,
+    params: RequestWithdrawalParams
+  ): Promise<RequestWithdrawalResponse> {
+    const endpoint = this.API.endpoints.requestWithdrawal(walletId)
+    const transformedParams = transformRequestWithdrawalParams(params)
+    const headers = await composeAPIHeaders(this.credentials, 'POST', endpoint, transformedParams)
+    const response = await post(endpoint, transformedParams, headers)
+    return response.data
+  }
+
+  /**
+   * Gets the webhook public key for a workspace
+   * @param workspaceId The workspace ID
+   * @returns Webhook public key response with base64 encoded ed25519 public key
+   */
+  async getWebhookPublicKey(workspaceId: string): Promise<WebhookPublicKeyResponse> {
+    const endpoint = this.API.endpoints.getWebhookPublicKey(workspaceId)
+    const headers = await composeAPIHeaders(this.credentials, 'GET', endpoint)
+    const response = await get(endpoint, headers)
+    return response.data
+  }
 }
 
 export class PaymentService {
@@ -380,6 +412,16 @@ export function transformRescanTransactionParams(data: RescanTransactionParams)
   }
 }
 
+export function transformRequestWithdrawalParams(data: RequestWithdrawalParams) {
+  return {
+    asset_id: data.assetId,
+    amount: data.amount,
+    recipient_address: data.recipientAddress,
+    ...(data.notes !== undefined && { notes: data.notes }),
+    ...(data.skipBalanceCheck !== undefined && { skip_balance_check: data.skipBalanceCheck })
+  }
+}
+
 ;(BigInt.prototype as any).toJSON = function () {
   return this.toString()
 }

package/src/config.ts

@@ -21,6 +21,8 @@ export interface APIEndpoints {
   getWalletAssets: (walletId: string) => string
   getDepositAddress: (walletId: string, addressType: string) => string
   rescanTransaction: () => string
+  requestWithdrawal: (walletId: string) => string
+  getWebhookPublicKey: (workspaceId: string) => string
 }
 
 const getBaseURL = (env: Environment): string => {
@@ -71,7 +73,9 @@ const createAPI = (env: Environment): APIConfig => {
       getWalletAssets: (walletId: string) => withBaseURL(`/wallets/${walletId}/assets`),
       getDepositAddress: (walletId: string, addressType: string) =>
         withBaseURL(`/wallets/${walletId}/deposit-address?address_type=${addressType}`),
-      rescanTransaction: () => withBaseURL('/networks/rescan-transaction')
+      rescanTransaction: () => withBaseURL('/networks/rescan-transaction'),
+      requestWithdrawal: (walletId: string) => withBaseURL(`/wallets/${walletId}/request-withdrawal`),
+      getWebhookPublicKey: (workspaceId: string) => withBaseURL(`/workspaces/${workspaceId}/webhook-verification-key`)
     }
   }
 }

package/src/enum.ts

@@ -1,6 +1,6 @@
 // Wallets
 export enum WalletType {
-  Standard = 'standard',
+  Hyper = 'standard',
   MPC = 'mpc'
 }
 
@@ -50,3 +50,13 @@ export enum WalletRole {
   Signer = 'wallet_signer',
   Viewer = 'wallet_viewer'
 }
+
+export enum WithdrawalStatus {
+  Pending = 'pending',
+  PendingApproval = 'pending_approval',
+  Approved = 'approved',
+  Rejected = 'rejected',
+  Processing = 'processing',
+  Completed = 'completed',
+  Failed = 'failed'
+}

package/src/sdk.ts

@@ -9,7 +9,10 @@ import {
   APICredentials,
   CreateWalletOptions,
   RescanTransactionParams,
-  WalletByWorkspaceResponse
+  WalletByWorkspaceResponse,
+  RequestWithdrawalParams,
+  RequestWithdrawalResponse,
+  WebhookPublicKeyResponse
 } from './types'
 import { validateUUID } from './utils'
 import { AddressType, WalletCreationStatus, WalletType } from './enum'
@@ -56,7 +59,7 @@ export class FystackSDK {
   ): Promise<CreateWalletResponse> {
     const {
       name,
-      walletType = WalletType.Standard,
+      walletType = WalletType.Hyper,
       sweepTaskParams,
       walletPurpose,
       sweepTaskId
@@ -183,4 +186,53 @@ export class FystackSDK {
 
     await this.apiService.rescanTransaction(params)
   }
+
+  /**
+   * Requests a withdrawal from a wallet
+   * @param walletId The ID of the wallet to withdraw from
+   * @param params Withdrawal parameters including asset, amount, and recipient
+   * @returns Promise with withdrawal response including auto_approved status and withdrawal details
+   */
+  async requestWithdrawal(
+    walletId: string,
+    params: RequestWithdrawalParams
+  ): Promise<RequestWithdrawalResponse> {
+    validateUUID(walletId, 'walletId')
+    validateUUID(params.assetId, 'assetId')
+
+    if (!params.amount || params.amount.trim() === '') {
+      throw new Error('Invalid amount provided')
+    }
+
+    if (!params.recipientAddress || params.recipientAddress.trim() === '') {
+      throw new Error('Invalid recipient address provided')
+    }
+
+    if (params.recipientAddress.length > 256) {
+      throw new Error('Recipient address exceeds maximum length of 256 characters')
+    }
+
+    if (params.notes && params.notes.length > 500) {
+      throw new Error('Notes exceed maximum length of 500 characters')
+    }
+
+    this.log(`Requesting withdrawal from wallet ${walletId}`)
+    const response = await this.apiService.requestWithdrawal(walletId, params)
+    this.log(`Withdrawal request completed, auto_approved: ${response.auto_approved}`)
+
+    return response
+  }
+
+  /**
+   * Gets the webhook public key for a workspace
+   * @param workspaceId The workspace ID
+   * @returns Promise with webhook public key (base64 encoded ed25519 public key)
+   */
+  async getWebhookPublicKey(workspaceId: string): Promise<WebhookPublicKeyResponse> {
+    validateUUID(workspaceId, 'workspaceId')
+
+    this.log(`Getting webhook public key for workspace ${workspaceId}`)
+    const response = await this.apiService.getWebhookPublicKey(workspaceId)
+    return response
+  }
 }