@fystack/sdk 0.1.0 → 0.1.2

package/dist/index.cjs

@@ -133,7 +133,13 @@ exports.WalletAddressType = void 0;
 })(exports.WalletAddressType || (exports.WalletAddressType = {}));
 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);
@@ -514,7 +520,7 @@ class FystackSDK {
     }
 }
 
-class ApexSigner extends ethers.AbstractSigner {
+class EtherSigner extends ethers.AbstractSigner {
     setWallet(walletId) {
         if (!walletId || walletId.trim() === '') {
             throw new Error('Invalid wallet ID provided');
@@ -534,7 +540,7 @@ class ApexSigner 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);
@@ -560,7 +566,7 @@ class ApexSigner extends ethers.AbstractSigner {
         }
     }
     connect(provider) {
-        return new ApexSigner(this.APICredentials, this.environment, provider);
+        return new EtherSigner(this.APICredentials, this.environment, provider);
     }
     async waitForSignature(walletId, transactionId) {
         const poller = new StatusPoller(this.pollerOptions);
@@ -665,7 +671,7 @@ class ApexSigner extends ethers.AbstractSigner {
         // Ensure all properties are properly resolved to their string representations
         const resolvedTx = await ethers.resolveProperties(populatedTx);
         const txObj = ethers.Transaction.from(resolvedTx);
-        console.log('txObj', txObj);
+        console.log('[WalletSDK] Tx Data', txObj);
         const txHash = await this.signTransaction(txObj);
         // Instead of creating a mock response, get the actual transaction from the provider
         const endTime = new Date();
@@ -795,7 +801,7 @@ 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);
@@ -842,7 +848,7 @@ class SolanaSigner {
             data: transaction,
             from: this.address
         };
-        // Call the signRaw API similar to ApexSigner
+        // Call the signRaw API similar to EtherSigner
         const response = await this.APIService.signTransaction(this.walletDetail.WalletID, {
             ...data,
             meta: {
@@ -850,7 +856,6 @@ class SolanaSigner {
             },
             chainId: '1399811149'
         });
-        console.log('respnpse', response);
         // Wait for the signature
         return this.waitForTransactionStatus(response.transaction_id);
     }
@@ -868,7 +873,6 @@ class SolanaSigner {
             message: messageStr,
             chain_id: 0 // Not used for Solana but required by API
         });
-        console.log('Respnse', response);
         return this.waitForTransactionStatus(response.transaction_id);
     }
     /**
@@ -940,6 +944,7 @@ class SolanaSigner {
         }
     }
     constructor(credentials, environment, pollerOptions){
+        this.APICredentials = credentials;
         this.APIKey = credentials.apiKey;
         this.APIService = new APIService(credentials, environment);
         this.pollerOptions = pollerOptions;
@@ -947,8 +952,8 @@ class SolanaSigner {
 }
 
 exports.APIService = APIService;
-exports.ApexSigner = ApexSigner;
 exports.DEFAULT_POLLER_OPTIONS = DEFAULT_POLLER_OPTIONS;
+exports.EtherSigner = EtherSigner;
 exports.FystackSDK = FystackSDK;
 exports.PaymentService = PaymentService;
 exports.SolanaSigner = SolanaSigner;

package/dist/index.d.cts

@@ -23,6 +23,7 @@ declare enum TxApprovalStatus {
 interface APICredentials {
     apiKey: string;
     apiSecret: string;
+    authToken?: string;
 }
 interface WebhookEvent {
     webhook_id: string;
@@ -229,7 +230,7 @@ declare class StatusPoller {
     poll<T>(pollingFn: () => Promise<T>, successCondition: (result: T) => boolean, errorCondition?: (result: T) => boolean | void): Promise<T>;
 }
 
-declare class ApexSigner extends AbstractSigner {
+declare class EtherSigner extends AbstractSigner {
     private address;
     private APICredentials;
     private APIService;
@@ -240,7 +241,7 @@ declare class ApexSigner extends AbstractSigner {
     setWallet(walletId: string): void;
     getAddress(): Promise<string>;
     private getChainId;
-    connect(provider: null | Provider): ApexSigner;
+    connect(provider: null | Provider): EtherSigner;
     private waitForSignature;
     private waitForTransactonStatus;
     signTransaction(tx: TransactionRequest): Promise<string>;
@@ -255,6 +256,7 @@ declare class SolanaSigner {
     private APIKey;
     private walletDetail;
     private pollerOptions?;
+    private APICredentials;
     constructor(credentials: APICredentials, environment: Environment, pollerOptions?: StatusPollerOptions);
     setWallet(walletId: string): void;
     getAddress(): Promise<string>;
@@ -608,4 +610,4 @@ declare function transformCreateWalletPayload(data: CreateWalletPayload): {
     wallet_type: WalletType;
 };
 
-export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, ApexSigner, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, Environment, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, WalletAddressType, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };
+export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, Environment, EtherSigner, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, WalletAddressType, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };

package/dist/index.d.mts

@@ -23,6 +23,7 @@ declare enum TxApprovalStatus {
 interface APICredentials {
     apiKey: string;
     apiSecret: string;
+    authToken?: string;
 }
 interface WebhookEvent {
     webhook_id: string;
@@ -229,7 +230,7 @@ declare class StatusPoller {
     poll<T>(pollingFn: () => Promise<T>, successCondition: (result: T) => boolean, errorCondition?: (result: T) => boolean | void): Promise<T>;
 }
 
-declare class ApexSigner extends AbstractSigner {
+declare class EtherSigner extends AbstractSigner {
     private address;
     private APICredentials;
     private APIService;
@@ -240,7 +241,7 @@ declare class ApexSigner extends AbstractSigner {
     setWallet(walletId: string): void;
     getAddress(): Promise<string>;
     private getChainId;
-    connect(provider: null | Provider): ApexSigner;
+    connect(provider: null | Provider): EtherSigner;
     private waitForSignature;
     private waitForTransactonStatus;
     signTransaction(tx: TransactionRequest): Promise<string>;
@@ -255,6 +256,7 @@ declare class SolanaSigner {
     private APIKey;
     private walletDetail;
     private pollerOptions?;
+    private APICredentials;
     constructor(credentials: APICredentials, environment: Environment, pollerOptions?: StatusPollerOptions);
     setWallet(walletId: string): void;
     getAddress(): Promise<string>;
@@ -608,4 +610,4 @@ declare function transformCreateWalletPayload(data: CreateWalletPayload): {
     wallet_type: WalletType;
 };
 
-export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, ApexSigner, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, Environment, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, WalletAddressType, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };
+export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, Environment, EtherSigner, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, WalletAddressType, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };

package/dist/index.esm.d.ts

@@ -23,6 +23,7 @@ declare enum TxApprovalStatus {
 interface APICredentials {
     apiKey: string;
     apiSecret: string;
+    authToken?: string;
 }
 interface WebhookEvent {
     webhook_id: string;
@@ -229,7 +230,7 @@ declare class StatusPoller {
     poll<T>(pollingFn: () => Promise<T>, successCondition: (result: T) => boolean, errorCondition?: (result: T) => boolean | void): Promise<T>;
 }
 
-declare class ApexSigner extends AbstractSigner {
+declare class EtherSigner extends AbstractSigner {
     private address;
     private APICredentials;
     private APIService;
@@ -240,7 +241,7 @@ declare class ApexSigner extends AbstractSigner {
     setWallet(walletId: string): void;
     getAddress(): Promise<string>;
     private getChainId;
-    connect(provider: null | Provider): ApexSigner;
+    connect(provider: null | Provider): EtherSigner;
     private waitForSignature;
     private waitForTransactonStatus;
     signTransaction(tx: TransactionRequest): Promise<string>;
@@ -255,6 +256,7 @@ declare class SolanaSigner {
     private APIKey;
     private walletDetail;
     private pollerOptions?;
+    private APICredentials;
     constructor(credentials: APICredentials, environment: Environment, pollerOptions?: StatusPollerOptions);
     setWallet(walletId: string): void;
     getAddress(): Promise<string>;
@@ -608,4 +610,4 @@ declare function transformCreateWalletPayload(data: CreateWalletPayload): {
     wallet_type: WalletType;
 };
 
-export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, ApexSigner, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, Environment, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, WalletAddressType, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };
+export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, Environment, EtherSigner, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, WalletAddressType, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };

package/dist/index.esm.js

@@ -125,7 +125,13 @@ var WalletAddressType;
 })(WalletAddressType || (WalletAddressType = {}));
 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);
@@ -506,7 +512,7 @@ class FystackSDK {
     }
 }
 
-class ApexSigner extends AbstractSigner {
+class EtherSigner extends AbstractSigner {
     setWallet(walletId) {
         if (!walletId || walletId.trim() === '') {
             throw new Error('Invalid wallet ID provided');
@@ -526,7 +532,7 @@ class ApexSigner 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);
@@ -552,7 +558,7 @@ class ApexSigner extends AbstractSigner {
         }
     }
     connect(provider) {
-        return new ApexSigner(this.APICredentials, this.environment, provider);
+        return new EtherSigner(this.APICredentials, this.environment, provider);
     }
     async waitForSignature(walletId, transactionId) {
         const poller = new StatusPoller(this.pollerOptions);
@@ -657,7 +663,7 @@ class ApexSigner extends AbstractSigner {
         // Ensure all properties are properly resolved to their string representations
         const resolvedTx = await resolveProperties(populatedTx);
         const txObj = Transaction.from(resolvedTx);
-        console.log('txObj', txObj);
+        console.log('[WalletSDK] Tx Data', txObj);
         const txHash = await this.signTransaction(txObj);
         // Instead of creating a mock response, get the actual transaction from the provider
         const endTime = new Date();
@@ -787,7 +793,7 @@ 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);
@@ -834,7 +840,7 @@ class SolanaSigner {
             data: transaction,
             from: this.address
         };
-        // Call the signRaw API similar to ApexSigner
+        // Call the signRaw API similar to EtherSigner
         const response = await this.APIService.signTransaction(this.walletDetail.WalletID, {
             ...data,
             meta: {
@@ -842,7 +848,6 @@ class SolanaSigner {
             },
             chainId: '1399811149'
         });
-        console.log('respnpse', response);
         // Wait for the signature
         return this.waitForTransactionStatus(response.transaction_id);
     }
@@ -860,7 +865,6 @@ class SolanaSigner {
             message: messageStr,
             chain_id: 0 // Not used for Solana but required by API
         });
-        console.log('Respnse', response);
         return this.waitForTransactionStatus(response.transaction_id);
     }
     /**
@@ -932,10 +936,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, ApexSigner, DEFAULT_POLLER_OPTIONS, Environment, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletAddressType, WalletCreationStatus, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };
+export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletAddressType, WalletCreationStatus, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };

package/dist/index.mjs

@@ -125,7 +125,13 @@ var WalletAddressType;
 })(WalletAddressType || (WalletAddressType = {}));
 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);
@@ -506,7 +512,7 @@ class FystackSDK {
     }
 }
 
-class ApexSigner extends AbstractSigner {
+class EtherSigner extends AbstractSigner {
     setWallet(walletId) {
         if (!walletId || walletId.trim() === '') {
             throw new Error('Invalid wallet ID provided');
@@ -526,7 +532,7 @@ class ApexSigner 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);
@@ -552,7 +558,7 @@ class ApexSigner extends AbstractSigner {
         }
     }
     connect(provider) {
-        return new ApexSigner(this.APICredentials, this.environment, provider);
+        return new EtherSigner(this.APICredentials, this.environment, provider);
     }
     async waitForSignature(walletId, transactionId) {
         const poller = new StatusPoller(this.pollerOptions);
@@ -657,7 +663,7 @@ class ApexSigner extends AbstractSigner {
         // Ensure all properties are properly resolved to their string representations
         const resolvedTx = await resolveProperties(populatedTx);
         const txObj = Transaction.from(resolvedTx);
-        console.log('txObj', txObj);
+        console.log('[WalletSDK] Tx Data', txObj);
         const txHash = await this.signTransaction(txObj);
         // Instead of creating a mock response, get the actual transaction from the provider
         const endTime = new Date();
@@ -787,7 +793,7 @@ 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);
@@ -834,7 +840,7 @@ class SolanaSigner {
             data: transaction,
             from: this.address
         };
-        // Call the signRaw API similar to ApexSigner
+        // Call the signRaw API similar to EtherSigner
         const response = await this.APIService.signTransaction(this.walletDetail.WalletID, {
             ...data,
             meta: {
@@ -842,7 +848,6 @@ class SolanaSigner {
             },
             chainId: '1399811149'
         });
-        console.log('respnpse', response);
         // Wait for the signature
         return this.waitForTransactionStatus(response.transaction_id);
     }
@@ -860,7 +865,6 @@ class SolanaSigner {
             message: messageStr,
             chain_id: 0 // Not used for Solana but required by API
         });
-        console.log('Respnse', response);
         return this.waitForTransactionStatus(response.transaction_id);
     }
     /**
@@ -932,10 +936,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, ApexSigner, DEFAULT_POLLER_OPTIONS, Environment, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletAddressType, WalletCreationStatus, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };
+export { APIService, AddressType, DEFAULT_POLLER_OPTIONS, Environment, EtherSigner, FystackSDK, PaymentService, SolanaSigner, StatusPoller, TransactionError, TxApprovalStatus, TxStatus, WalletAddressType, WalletCreationStatus, WalletType, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };

package/dist/types/index.d.ts

@@ -23,6 +23,7 @@ declare enum TxApprovalStatus {
 interface APICredentials {
     apiKey: string;
     apiSecret: string;
+    authToken?: string;
 }
 interface WebhookEvent {
     webhook_id: string;
@@ -229,7 +230,7 @@ declare class StatusPoller {
     poll<T>(pollingFn: () => Promise<T>, successCondition: (result: T) => boolean, errorCondition?: (result: T) => boolean | void): Promise<T>;
 }
 
-declare class ApexSigner extends AbstractSigner {
+declare class EtherSigner extends AbstractSigner {
     private address;
     private APICredentials;
     private APIService;
@@ -240,7 +241,7 @@ declare class ApexSigner extends AbstractSigner {
     setWallet(walletId: string): void;
     getAddress(): Promise<string>;
     private getChainId;
-    connect(provider: null | Provider): ApexSigner;
+    connect(provider: null | Provider): EtherSigner;
     private waitForSignature;
     private waitForTransactonStatus;
     signTransaction(tx: TransactionRequest): Promise<string>;
@@ -255,6 +256,7 @@ declare class SolanaSigner {
     private APIKey;
     private walletDetail;
     private pollerOptions?;
+    private APICredentials;
     constructor(credentials: APICredentials, environment: Environment, pollerOptions?: StatusPollerOptions);
     setWallet(walletId: string): void;
     getAddress(): Promise<string>;
@@ -608,4 +610,4 @@ declare function transformCreateWalletPayload(data: CreateWalletPayload): {
     wallet_type: WalletType;
 };
 
-export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, ApexSigner, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, Environment, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, WalletAddressType, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };
+export { type APIConfig, type APICredentials, type APIEndpoints, APIService, AddressType, type ApprovalInfo, type CreateWalletOptions, type CreateWalletPayload, type CreateWalletResponse, DEFAULT_POLLER_OPTIONS, type DepositAddressResponse, Environment, EtherSigner, FystackSDK, type HMACParams, PaymentService, type PaymentServiceParams, type SDKOptions, type SignRequestParams, type SignResponse, type SignatureStatusResponse, SolanaSigner, StatusPoller, type StatusPollerOptions, TransactionError, type TransactionStatusResponse, TxApprovalStatus, TxStatus, WalletAddressType, type WalletAsset, type WalletAssetDetail, type WalletAssetNetwork, WalletCreationStatus, type WalletCreationStatusResponse, type WalletDetail, WalletType, type WebhookEvent, WebhookService, createAPI, get, post, transformCreateWalletPayload, transformWalletDetail };

package/package.json

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

package/readme.md

@@ -0,0 +1,200 @@
+# Fystack Platform SDK
+
+A Typescript SDK for Fystack's wallet and payment services, providing seamless integration with both EVM and Solana blockchains.
+
+## Installation
+
+```bash
+npm install @fystack/sdk
+```
+
+## Usage
+
+### Wallet Management
+
+Create and manage blockchain wallets with minimal code.
+
+```typescript
+import { FystackSDK } from '@fystack/sdk'
+import { Environment, WalletType } from '@fystack/sdk'
+
+// Initialize the SDK
+const sdk = new FystackSDK({
+  credentials: {
+    apiKey: 'YOUR_API_KEY',
+    apiSecret: 'YOUR_API_SECRET'
+  },
+  environment: Environment.Production,
+  logger: true // Enable logging
+})
+
+const response = await sdk.createWallet({
+  name: 'My Blockchain Wallet',
+  walletType: WalletType.MPC // Multi-Party Computation wallet
+})
+
+console.log('Wallet ID:', response.wallet_id)
+console.log('Status:', response.status)
+
+// Check wallet creation status
+const statusResponse = await sdk.getWalletCreationStatus(response.wallet_id)
+console.log('WalletID:', statusResponse.wallet_id)
+```
+
+### Solana Transaction Signing
+
+```typescript
+import { SolanaSigner } from '@fystack/sdk'
+import { Connection, PublicKey, SystemProgram, Transaction } from '@solana/web3.js'
+
+async function signSolanaTransaction() {
+  // Initialize the signer
+  const signer = new SolanaSigner(
+    {
+      apiKey: 'YOUR_API_KEY',
+      apiSecret: 'YOUR_API_SECRET'
+    },
+    Environment.Production
+  )
+
+  // Get signer's address
+  const fromAddress = await signer.getAddress()
+  const fromPubkey = new PublicKey(fromAddress)
+
+  // Set recipient address
+  const toAddress = 'RECIPIENT_SOLANA_ADDRESS'
+  const toPubkey = new PublicKey(toAddress)
+
+  // Connect to Solana network
+  const connection = new Connection('https://api.mainnet-beta.solana.com/')
+
+  // Get recent blockhash
+  const { blockhash } = await connection.getLatestBlockhash({
+    commitment: 'finalized'
+  })
+
+  // Create transfer instruction
+  const transferInstruction = SystemProgram.transfer({
+    fromPubkey,
+    toPubkey,
+    lamports: 1000 // 0.000001 SOL
+  })
+
+  // Create and setup transaction
+  const transaction = new Transaction().add(transferInstruction)
+  transaction.recentBlockhash = blockhash
+  transaction.feePayer = fromPubkey
+
+  // Serialize the transaction to base64
+  const serializedTransaction = transaction
+    .serialize({
+      requireAllSignatures: false,
+      verifySignatures: false
+    })
+    .toString('base64')
+
+  // Sign the transaction
+  const signature = await signer.signTransaction(serializedTransaction)
+  console.log('Transaction signature:', signature)
+
+  return signature
+}
+```
+
+### Ethereum Transaction Signing
+
+```typescript
+import { EtherSigner } from '@fystack/sdk'
+import { JsonRpcProvider, ethers } from 'ethers'
+
+async function signEthereumTransaction() {
+  const address = await signer.getAddress()
+  console.log('Wallet address:', address)
+
+  // Connect to a provider
+  const provider = new JsonRpcProvider('YOUR_RPC_ENDPOINT')
+  const signerWithProvider = signer.connect(provider)
+
+  // Send a transaction
+  const tx = await signerWithProvider.sendTransaction({
+    to: '0xRecipientAddress',
+    value: ethers.parseEther('0.0001') // Amount in ETH
+  })
+
+  console.log('Transaction hash:', tx.hash)
+  return tx.hash
+}
+```
+
+### Payment Processing
+
+Create checkouts and process payments.
+
+```typescript
+import { PaymentService } from '@fystack/sdk'
+import { Environment } from '@fystack/sdk'
+
+async function createPaymentCheckout() {
+  const paymentService = new PaymentService({
+    apiKey: 'YOUR_API_KEY',
+    environment: Environment.Production
+  })
+
+  // Create a checkout
+  const response = await paymentService.createCheckout({
+    price: '10.50',
+    currency: 'USD',
+    supported_assets: [
+      'SOL:1399811149', // Format: "ASSET:CHAIN_ID"
+      'USDC:1399811149'
+    ],
+    description: 'Premium subscription package',
+    success_url: 'https://yourapp.com/payment/success',
+    cancel_url: 'https://yourapp.com/payment/cancel',
+    product_id: 'YOUR_PRODUCT_ID',
+    customer_id: 'YOUR_CUSTOMER_ID',
+    order_id: 'YOUR_ORDER_ID',
+    enable_localization: false,
+    destination_wallet_id: 'YOUR_DESTINATION_WALLET_ID',
+    expiry_duration_seconds: 3600 // 1 hour
+  })
+
+  console.log('Checkout created:', response.id)
+
+  // Get checkout details
+  const checkout = await paymentService.getCheckout(response.id)
+
+  // Create payment using the first supported asset
+  const payment = await paymentService.createCheckoutPayment(response.id, {
+    pay_asset_id: checkout.supported_assets[0].id
+  })
+
+  console.log('Payment created:', payment.id)
+  console.log('Send payment to:', payment.deposit_address)
+
+  // Get payment status
+  const paymentStatus = await paymentService.getCheckoutPayment(payment.id)
+  console.log('Payment status:', paymentStatus)
+
+  return payment
+}
+```
+
+### Webhook Verification
+
+```typescript
+import { APIService } from '@fystack/sdk'
+
+function verifyWebhook(event, signature) {
+  const apiService = new APIService(
+    {
+      apiKey: 'YOUR_API_KEY',
+      apiSecret: 'YOUR_API_SECRET'
+    },
+    Environment.Production
+  )
+
+  const isValid = apiService.Webhook.verifyEvent(event, signature)
+  return isValid
+}
+```

package/src/api.ts

@@ -67,7 +67,13 @@ async function composeAPIHeaders(
   body: Record<string, any> = {}
 ): Promise<Record<string, string>> {
   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 {}
   }
 

package/src/signer.ts

@@ -20,7 +20,7 @@ import { APICredentials, TransactionStatusResponse, TxStatus, TransactionError }
 import { Environment } from './config'
 import { StatusPoller, StatusPollerOptions } from './utils/statusPoller'
 
-export class ApexSigner extends AbstractSigner {
+export class EtherSigner extends AbstractSigner {
   private address!: string
   private APICredentials!: APICredentials
   private APIService: APIService
@@ -64,7 +64,11 @@ export class ApexSigner extends AbstractSigner {
       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!')
     }
 
@@ -99,8 +103,8 @@ export class ApexSigner extends AbstractSigner {
     }
   }
 
-  connect(provider: null | Provider): ApexSigner {
-    return new ApexSigner(this.APICredentials, this.environment, provider)
+  connect(provider: null | Provider): EtherSigner {
+    return new EtherSigner(this.APICredentials, this.environment, provider)
   }
 
   private async waitForSignature(walletId: string, transactionId: string): Promise<string> {
@@ -253,7 +257,7 @@ export class ApexSigner extends AbstractSigner {
     const resolvedTx = (await resolveProperties(populatedTx)) as TransactionLike<string>
     const txObj = Transaction.from(resolvedTx)
 
-    console.log('txObj', txObj)
+    console.log('[WalletSDK] Tx Data', txObj)
 
     const txHash = await this.signTransaction(txObj)
 

package/src/solanaSigner.ts

@@ -12,12 +12,14 @@ export class SolanaSigner {
   private APIKey: string
   private walletDetail: WalletDetail
   private pollerOptions?: StatusPollerOptions
+  private APICredentials!: APICredentials
 
   constructor(
     credentials: APICredentials,
     environment: Environment,
     pollerOptions?: StatusPollerOptions
   ) {
+    this.APICredentials = credentials
     this.APIKey = credentials.apiKey
     this.APIService = new APIService(credentials, environment)
     this.pollerOptions = pollerOptions
@@ -45,7 +47,11 @@ export class SolanaSigner {
       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!')
     }
 
@@ -120,7 +126,7 @@ export class SolanaSigner {
       from: this.address
     }
 
-    // Call the signRaw API similar to ApexSigner
+    // Call the signRaw API similar to EtherSigner
     const response = await this.APIService.signTransaction(this.walletDetail.WalletID, {
       ...data,
       meta: {
@@ -128,7 +134,6 @@ export class SolanaSigner {
       },
       chainId: '1399811149'
     })
-    console.log('respnpse', response)
 
     // Wait for the signature
     return this.waitForTransactionStatus(response.transaction_id)
@@ -153,8 +158,6 @@ export class SolanaSigner {
       chain_id: 0 // Not used for Solana but required by API
     })
 
-    console.log('Respnse', response)
-
     return this.waitForTransactionStatus(response.transaction_id)
   }
 

package/src/types.ts

@@ -27,6 +27,9 @@ export enum TxApprovalStatus {
 export interface APICredentials {
   apiKey: string
   apiSecret: string
+
+  // Optional
+  authToken?: string
 }
 
 export interface WebhookEvent {