@fystack/sdk 0.1.12 → 0.1.14

package/dist/index.cjs

@@ -26,11 +26,25 @@ const getBaseURL = (env)=>{
         case "sandbox":
             return 'https://api-dev.fystack.io';
         case "production":
-            return 'https://fystack.excelon.io';
+            return 'https://api.fystack.io';
     }
 };
-const createAPI = (env)=>{
-    const baseURL = `${getBaseURL(env)}/api/v1`;
+function validateDomain(domain) {
+    const domainPattern = /^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/;
+    if (!domainPattern.test(domain)) {
+        throw new Error(`Invalid domain: "${domain}". Expected a valid domain like "api.example.com"`);
+    }
+}
+const createAPI = (env, domain)=>{
+    let baseURL;
+    if (domain) {
+        validateDomain(domain);
+        baseURL = `https://${domain}/api/v1`;
+    } else if (env) {
+        baseURL = `${getBaseURL(env)}/api/v1`;
+    } else {
+        baseURL = `${getBaseURL("production")}/api/v1`;
+    }
     const withBaseURL = (path)=>`${baseURL}${path}`;
     return {
         baseURL,
@@ -145,6 +159,7 @@ exports.WalletPurpose = void 0;
     WalletPurpose["Custody"] = "custody";
     WalletPurpose["User"] = "user";
     WalletPurpose["Payment"] = "payment";
+    WalletPurpose["OneTimeUse"] = "one_time_use";
 })(exports.WalletPurpose || (exports.WalletPurpose = {}));
 exports.WalletCreationStatus = void 0;
 (function(WalletCreationStatus) {
@@ -356,10 +371,10 @@ class APIService {
         const response = await post(endpoint, transformedParams, headers);
         return response.data;
     }
-    constructor(credentials, environment){
+    constructor(credentials, environment, domain){
         this.credentials = credentials;
         this.Webhook = new WebhookService(credentials);
-        this.API = createAPI(environment);
+        this.API = createAPI(environment, domain);
     }
 }
 class PaymentService {
@@ -388,7 +403,7 @@ class PaymentService {
     }
     constructor(params){
         this.apiKey = params.apiKey;
-        this.API = createAPI(params.environment);
+        this.API = createAPI(params.environment, params.domain);
     }
 }
 class WebhookService {
@@ -481,7 +496,15 @@ function transformRescanTransactionParams(data) {
 }
 function transformRequestWithdrawalParams(data) {
     return {
-        asset_id: data.assetId,
+        ...data.assetId !== undefined && {
+            asset_id: data.assetId
+        },
+        ...data.network !== undefined && {
+            network: data.network
+        },
+        ...data.asset !== undefined && {
+            asset: data.asset
+        },
         amount: data.amount,
         recipient_address: data.recipientAddress,
         ...data.notes !== undefined && {
@@ -690,7 +713,11 @@ class FystackSDK {
    * @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.assetId) {
+            validateUUID(params.assetId, 'assetId');
+        } else if (!params.asset || !params.network) {
+            throw new Error('Either assetId or both asset and network must be provided');
+        }
         if (!params.amount || params.amount.trim() === '') {
             throw new Error('Invalid amount provided');
         }
@@ -731,8 +758,8 @@ class FystackSDK {
         return this.workspaceId;
     }
     constructor(options){
-        const { credentials, workspaceId, environment = exports.Environment.Production, debug = false } = options;
-        this.apiService = new APIService(credentials, environment);
+        const { credentials, workspaceId, environment = exports.Environment.Production, domain, debug = false } = options;
+        this.apiService = new APIService(credentials, environment, domain);
         this.debugEnabled = debug;
         this.workspaceId = workspaceId;
         this.automation = new AutomationNamespace(this);

package/dist/index.d.cts

@@ -11,7 +11,8 @@ declare enum WalletPurpose {
     Deployment = "deployment",
     Custody = "custody",
     User = "user",
-    Payment = "payment"
+    Payment = "payment",
+    OneTimeUse = "one_time_use"
 }
 declare enum WalletCreationStatus {
     Pending = "pending",
@@ -95,7 +96,7 @@ interface APIConfig {
     baseURL: string;
     endpoints: APIEndpoints;
 }
-declare const createAPI: (env: Environment) => APIConfig;
+declare const createAPI: (env?: Environment, domain?: string) => APIConfig;
 
 declare class TransactionError extends Error {
     readonly code: string;
@@ -237,7 +238,9 @@ interface WalletByWorkspaceResponse {
     wallet_purpose: string;
 }
 interface RequestWithdrawalParams {
-    assetId: string;
+    assetId?: string;
+    network?: string;
+    asset?: string;
     amount: string;
     recipientAddress: string;
     notes?: string;
@@ -372,10 +375,15 @@ interface Asset {
     network_id: string;
     network?: Network;
 }
+interface AcceptedAsset {
+    asset: string;
+    network: string;
+}
 interface CreateCheckoutPayload {
     price: string;
     currency: string;
-    supported_assets: string[];
+    supported_assets?: string[];
+    accepted_assets?: AcceptedAsset[];
     underpaid_cover_percent?: number;
     description?: string;
     success_url?: string;
@@ -616,13 +624,14 @@ interface CreateWalletPayload {
 }
 interface PaymentServiceParams {
     apiKey: string;
-    environment: Environment;
+    environment?: Environment;
+    domain?: string;
 }
 declare class APIService {
     private credentials;
     Webhook: WebhookService;
     private API;
-    constructor(credentials: APICredentials, environment: Environment);
+    constructor(credentials: APICredentials, environment?: Environment, domain?: string);
     getWallets(workspaceId: string): Promise<WalletByWorkspaceResponse[]>;
     getWalletDetail(addressType?: AddressType, walletId?: string): Promise<WalletDetail>;
     requestSign(walletId: string, params: SignRequestParams, options?: Record<string, string>): Promise<SignResponse>;
@@ -696,9 +705,11 @@ declare function transformRescanTransactionParams(data: RescanTransactionParams)
 declare function transformRequestWithdrawalParams(data: RequestWithdrawalParams): {
     skip_balance_check?: boolean | undefined;
     notes?: string | undefined;
-    asset_id: string;
     amount: string;
     recipient_address: string;
+    asset?: string | undefined;
+    network?: string | undefined;
+    asset_id?: string | undefined;
 };
 declare function transformCreateSweepTaskParams(data: CreateSweepTaskParams): {
     enabled?: boolean | undefined;
@@ -720,6 +731,7 @@ interface SDKOptions {
     credentials: APICredentials;
     workspaceId?: string;
     environment?: Environment;
+    domain?: string;
     /** Enable debug logging. Defaults to false */
     debug?: boolean;
 }

package/dist/index.d.mts

@@ -11,7 +11,8 @@ declare enum WalletPurpose {
     Deployment = "deployment",
     Custody = "custody",
     User = "user",
-    Payment = "payment"
+    Payment = "payment",
+    OneTimeUse = "one_time_use"
 }
 declare enum WalletCreationStatus {
     Pending = "pending",
@@ -95,7 +96,7 @@ interface APIConfig {
     baseURL: string;
     endpoints: APIEndpoints;
 }
-declare const createAPI: (env: Environment) => APIConfig;
+declare const createAPI: (env?: Environment, domain?: string) => APIConfig;
 
 declare class TransactionError extends Error {
     readonly code: string;
@@ -237,7 +238,9 @@ interface WalletByWorkspaceResponse {
     wallet_purpose: string;
 }
 interface RequestWithdrawalParams {
-    assetId: string;
+    assetId?: string;
+    network?: string;
+    asset?: string;
     amount: string;
     recipientAddress: string;
     notes?: string;
@@ -372,10 +375,15 @@ interface Asset {
     network_id: string;
     network?: Network;
 }
+interface AcceptedAsset {
+    asset: string;
+    network: string;
+}
 interface CreateCheckoutPayload {
     price: string;
     currency: string;
-    supported_assets: string[];
+    supported_assets?: string[];
+    accepted_assets?: AcceptedAsset[];
     underpaid_cover_percent?: number;
     description?: string;
     success_url?: string;
@@ -616,13 +624,14 @@ interface CreateWalletPayload {
 }
 interface PaymentServiceParams {
     apiKey: string;
-    environment: Environment;
+    environment?: Environment;
+    domain?: string;
 }
 declare class APIService {
     private credentials;
     Webhook: WebhookService;
     private API;
-    constructor(credentials: APICredentials, environment: Environment);
+    constructor(credentials: APICredentials, environment?: Environment, domain?: string);
     getWallets(workspaceId: string): Promise<WalletByWorkspaceResponse[]>;
     getWalletDetail(addressType?: AddressType, walletId?: string): Promise<WalletDetail>;
     requestSign(walletId: string, params: SignRequestParams, options?: Record<string, string>): Promise<SignResponse>;
@@ -696,9 +705,11 @@ declare function transformRescanTransactionParams(data: RescanTransactionParams)
 declare function transformRequestWithdrawalParams(data: RequestWithdrawalParams): {
     skip_balance_check?: boolean | undefined;
     notes?: string | undefined;
-    asset_id: string;
     amount: string;
     recipient_address: string;
+    asset?: string | undefined;
+    network?: string | undefined;
+    asset_id?: string | undefined;
 };
 declare function transformCreateSweepTaskParams(data: CreateSweepTaskParams): {
     enabled?: boolean | undefined;
@@ -720,6 +731,7 @@ interface SDKOptions {
     credentials: APICredentials;
     workspaceId?: string;
     environment?: Environment;
+    domain?: string;
     /** Enable debug logging. Defaults to false */
     debug?: boolean;
 }

package/dist/index.esm.d.ts

@@ -11,7 +11,8 @@ declare enum WalletPurpose {
     Deployment = "deployment",
     Custody = "custody",
     User = "user",
-    Payment = "payment"
+    Payment = "payment",
+    OneTimeUse = "one_time_use"
 }
 declare enum WalletCreationStatus {
     Pending = "pending",
@@ -95,7 +96,7 @@ interface APIConfig {
     baseURL: string;
     endpoints: APIEndpoints;
 }
-declare const createAPI: (env: Environment) => APIConfig;
+declare const createAPI: (env?: Environment, domain?: string) => APIConfig;
 
 declare class TransactionError extends Error {
     readonly code: string;
@@ -237,7 +238,9 @@ interface WalletByWorkspaceResponse {
     wallet_purpose: string;
 }
 interface RequestWithdrawalParams {
-    assetId: string;
+    assetId?: string;
+    network?: string;
+    asset?: string;
     amount: string;
     recipientAddress: string;
     notes?: string;
@@ -372,10 +375,15 @@ interface Asset {
     network_id: string;
     network?: Network;
 }
+interface AcceptedAsset {
+    asset: string;
+    network: string;
+}
 interface CreateCheckoutPayload {
     price: string;
     currency: string;
-    supported_assets: string[];
+    supported_assets?: string[];
+    accepted_assets?: AcceptedAsset[];
     underpaid_cover_percent?: number;
     description?: string;
     success_url?: string;
@@ -616,13 +624,14 @@ interface CreateWalletPayload {
 }
 interface PaymentServiceParams {
     apiKey: string;
-    environment: Environment;
+    environment?: Environment;
+    domain?: string;
 }
 declare class APIService {
     private credentials;
     Webhook: WebhookService;
     private API;
-    constructor(credentials: APICredentials, environment: Environment);
+    constructor(credentials: APICredentials, environment?: Environment, domain?: string);
     getWallets(workspaceId: string): Promise<WalletByWorkspaceResponse[]>;
     getWalletDetail(addressType?: AddressType, walletId?: string): Promise<WalletDetail>;
     requestSign(walletId: string, params: SignRequestParams, options?: Record<string, string>): Promise<SignResponse>;
@@ -696,9 +705,11 @@ declare function transformRescanTransactionParams(data: RescanTransactionParams)
 declare function transformRequestWithdrawalParams(data: RequestWithdrawalParams): {
     skip_balance_check?: boolean | undefined;
     notes?: string | undefined;
-    asset_id: string;
     amount: string;
     recipient_address: string;
+    asset?: string | undefined;
+    network?: string | undefined;
+    asset_id?: string | undefined;
 };
 declare function transformCreateSweepTaskParams(data: CreateSweepTaskParams): {
     enabled?: boolean | undefined;
@@ -720,6 +731,7 @@ interface SDKOptions {
     credentials: APICredentials;
     workspaceId?: string;
     environment?: Environment;
+    domain?: string;
     /** Enable debug logging. Defaults to false */
     debug?: boolean;
 }

package/dist/index.esm.js

@@ -18,11 +18,25 @@ const getBaseURL = (env)=>{
         case "sandbox":
             return 'https://api-dev.fystack.io';
         case "production":
-            return 'https://fystack.excelon.io';
+            return 'https://api.fystack.io';
     }
 };
-const createAPI = (env)=>{
-    const baseURL = `${getBaseURL(env)}/api/v1`;
+function validateDomain(domain) {
+    const domainPattern = /^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/;
+    if (!domainPattern.test(domain)) {
+        throw new Error(`Invalid domain: "${domain}". Expected a valid domain like "api.example.com"`);
+    }
+}
+const createAPI = (env, domain)=>{
+    let baseURL;
+    if (domain) {
+        validateDomain(domain);
+        baseURL = `https://${domain}/api/v1`;
+    } else if (env) {
+        baseURL = `${getBaseURL(env)}/api/v1`;
+    } else {
+        baseURL = `${getBaseURL("production")}/api/v1`;
+    }
     const withBaseURL = (path)=>`${baseURL}${path}`;
     return {
         baseURL,
@@ -137,6 +151,7 @@ var WalletPurpose;
     WalletPurpose["Custody"] = "custody";
     WalletPurpose["User"] = "user";
     WalletPurpose["Payment"] = "payment";
+    WalletPurpose["OneTimeUse"] = "one_time_use";
 })(WalletPurpose || (WalletPurpose = {}));
 var WalletCreationStatus;
 (function(WalletCreationStatus) {
@@ -348,10 +363,10 @@ class APIService {
         const response = await post(endpoint, transformedParams, headers);
         return response.data;
     }
-    constructor(credentials, environment){
+    constructor(credentials, environment, domain){
         this.credentials = credentials;
         this.Webhook = new WebhookService(credentials);
-        this.API = createAPI(environment);
+        this.API = createAPI(environment, domain);
     }
 }
 class PaymentService {
@@ -380,7 +395,7 @@ class PaymentService {
     }
     constructor(params){
         this.apiKey = params.apiKey;
-        this.API = createAPI(params.environment);
+        this.API = createAPI(params.environment, params.domain);
     }
 }
 class WebhookService {
@@ -473,7 +488,15 @@ function transformRescanTransactionParams(data) {
 }
 function transformRequestWithdrawalParams(data) {
     return {
-        asset_id: data.assetId,
+        ...data.assetId !== undefined && {
+            asset_id: data.assetId
+        },
+        ...data.network !== undefined && {
+            network: data.network
+        },
+        ...data.asset !== undefined && {
+            asset: data.asset
+        },
         amount: data.amount,
         recipient_address: data.recipientAddress,
         ...data.notes !== undefined && {
@@ -682,7 +705,11 @@ class FystackSDK {
    * @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.assetId) {
+            validateUUID(params.assetId, 'assetId');
+        } else if (!params.asset || !params.network) {
+            throw new Error('Either assetId or both asset and network must be provided');
+        }
         if (!params.amount || params.amount.trim() === '') {
             throw new Error('Invalid amount provided');
         }
@@ -723,8 +750,8 @@ class FystackSDK {
         return this.workspaceId;
     }
     constructor(options){
-        const { credentials, workspaceId, environment = Environment.Production, debug = false } = options;
-        this.apiService = new APIService(credentials, environment);
+        const { credentials, workspaceId, environment = Environment.Production, domain, debug = false } = options;
+        this.apiService = new APIService(credentials, environment, domain);
         this.debugEnabled = debug;
         this.workspaceId = workspaceId;
         this.automation = new AutomationNamespace(this);

package/dist/index.mjs

@@ -18,11 +18,25 @@ const getBaseURL = (env)=>{
         case "sandbox":
             return 'https://api-dev.fystack.io';
         case "production":
-            return 'https://fystack.excelon.io';
+            return 'https://api.fystack.io';
     }
 };
-const createAPI = (env)=>{
-    const baseURL = `${getBaseURL(env)}/api/v1`;
+function validateDomain(domain) {
+    const domainPattern = /^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/;
+    if (!domainPattern.test(domain)) {
+        throw new Error(`Invalid domain: "${domain}". Expected a valid domain like "api.example.com"`);
+    }
+}
+const createAPI = (env, domain)=>{
+    let baseURL;
+    if (domain) {
+        validateDomain(domain);
+        baseURL = `https://${domain}/api/v1`;
+    } else if (env) {
+        baseURL = `${getBaseURL(env)}/api/v1`;
+    } else {
+        baseURL = `${getBaseURL("production")}/api/v1`;
+    }
     const withBaseURL = (path)=>`${baseURL}${path}`;
     return {
         baseURL,
@@ -137,6 +151,7 @@ var WalletPurpose;
     WalletPurpose["Custody"] = "custody";
     WalletPurpose["User"] = "user";
     WalletPurpose["Payment"] = "payment";
+    WalletPurpose["OneTimeUse"] = "one_time_use";
 })(WalletPurpose || (WalletPurpose = {}));
 var WalletCreationStatus;
 (function(WalletCreationStatus) {
@@ -348,10 +363,10 @@ class APIService {
         const response = await post(endpoint, transformedParams, headers);
         return response.data;
     }
-    constructor(credentials, environment){
+    constructor(credentials, environment, domain){
         this.credentials = credentials;
         this.Webhook = new WebhookService(credentials);
-        this.API = createAPI(environment);
+        this.API = createAPI(environment, domain);
     }
 }
 class PaymentService {
@@ -380,7 +395,7 @@ class PaymentService {
     }
     constructor(params){
         this.apiKey = params.apiKey;
-        this.API = createAPI(params.environment);
+        this.API = createAPI(params.environment, params.domain);
     }
 }
 class WebhookService {
@@ -473,7 +488,15 @@ function transformRescanTransactionParams(data) {
 }
 function transformRequestWithdrawalParams(data) {
     return {
-        asset_id: data.assetId,
+        ...data.assetId !== undefined && {
+            asset_id: data.assetId
+        },
+        ...data.network !== undefined && {
+            network: data.network
+        },
+        ...data.asset !== undefined && {
+            asset: data.asset
+        },
         amount: data.amount,
         recipient_address: data.recipientAddress,
         ...data.notes !== undefined && {
@@ -682,7 +705,11 @@ class FystackSDK {
    * @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.assetId) {
+            validateUUID(params.assetId, 'assetId');
+        } else if (!params.asset || !params.network) {
+            throw new Error('Either assetId or both asset and network must be provided');
+        }
         if (!params.amount || params.amount.trim() === '') {
             throw new Error('Invalid amount provided');
         }
@@ -723,8 +750,8 @@ class FystackSDK {
         return this.workspaceId;
     }
     constructor(options){
-        const { credentials, workspaceId, environment = Environment.Production, debug = false } = options;
-        this.apiService = new APIService(credentials, environment);
+        const { credentials, workspaceId, environment = Environment.Production, domain, debug = false } = options;
+        this.apiService = new APIService(credentials, environment, domain);
         this.debugEnabled = debug;
         this.workspaceId = workspaceId;
         this.automation = new AutomationNamespace(this);

package/dist/types/index.d.ts

@@ -11,7 +11,8 @@ declare enum WalletPurpose {
     Deployment = "deployment",
     Custody = "custody",
     User = "user",
-    Payment = "payment"
+    Payment = "payment",
+    OneTimeUse = "one_time_use"
 }
 declare enum WalletCreationStatus {
     Pending = "pending",
@@ -95,7 +96,7 @@ interface APIConfig {
     baseURL: string;
     endpoints: APIEndpoints;
 }
-declare const createAPI: (env: Environment) => APIConfig;
+declare const createAPI: (env?: Environment, domain?: string) => APIConfig;
 
 declare class TransactionError extends Error {
     readonly code: string;
@@ -237,7 +238,9 @@ interface WalletByWorkspaceResponse {
     wallet_purpose: string;
 }
 interface RequestWithdrawalParams {
-    assetId: string;
+    assetId?: string;
+    network?: string;
+    asset?: string;
     amount: string;
     recipientAddress: string;
     notes?: string;
@@ -372,10 +375,15 @@ interface Asset {
     network_id: string;
     network?: Network;
 }
+interface AcceptedAsset {
+    asset: string;
+    network: string;
+}
 interface CreateCheckoutPayload {
     price: string;
     currency: string;
-    supported_assets: string[];
+    supported_assets?: string[];
+    accepted_assets?: AcceptedAsset[];
     underpaid_cover_percent?: number;
     description?: string;
     success_url?: string;
@@ -616,13 +624,14 @@ interface CreateWalletPayload {
 }
 interface PaymentServiceParams {
     apiKey: string;
-    environment: Environment;
+    environment?: Environment;
+    domain?: string;
 }
 declare class APIService {
     private credentials;
     Webhook: WebhookService;
     private API;
-    constructor(credentials: APICredentials, environment: Environment);
+    constructor(credentials: APICredentials, environment?: Environment, domain?: string);
     getWallets(workspaceId: string): Promise<WalletByWorkspaceResponse[]>;
     getWalletDetail(addressType?: AddressType, walletId?: string): Promise<WalletDetail>;
     requestSign(walletId: string, params: SignRequestParams, options?: Record<string, string>): Promise<SignResponse>;
@@ -696,9 +705,11 @@ declare function transformRescanTransactionParams(data: RescanTransactionParams)
 declare function transformRequestWithdrawalParams(data: RequestWithdrawalParams): {
     skip_balance_check?: boolean | undefined;
     notes?: string | undefined;
-    asset_id: string;
     amount: string;
     recipient_address: string;
+    asset?: string | undefined;
+    network?: string | undefined;
+    asset_id?: string | undefined;
 };
 declare function transformCreateSweepTaskParams(data: CreateSweepTaskParams): {
     enabled?: boolean | undefined;
@@ -720,6 +731,7 @@ interface SDKOptions {
     credentials: APICredentials;
     workspaceId?: string;
     environment?: Environment;
+    domain?: string;
     /** Enable debug logging. Defaults to false */
     debug?: boolean;
 }

package/package.json

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

package/readme.md

@@ -25,6 +25,26 @@ const sdk = new FystackSDK({
 })
 ```
 
+### Self-Hosted
+
+For customers running their own Fystack instance, provide your custom domain instead of an environment:
+
+```typescript
+import { FystackSDK } from '@fystack/sdk'
+
+const sdk = new FystackSDK({
+  credentials: {
+    apiKey: 'YOUR_API_KEY',
+    apiSecret: 'YOUR_API_SECRET'
+  },
+  workspaceId: 'YOUR_WORKSPACE_ID',
+  domain: 'api.your-company.com',
+  debug: true
+})
+```
+
+> When `domain` is provided, it takes priority over `environment`. The SDK will connect to `https://<domain>/api/v1`.
+
 ## Create Wallet
 
 Fystack supports two wallet types:
@@ -102,11 +122,14 @@ console.log('Tron Address:', tron.address)
 
 ## Create Withdrawal
 
-Request a withdrawal from a wallet to an external address.
+Request a withdrawal from a wallet to an external address. You can identify the asset either by `assetId` or by `asset` symbol + `network` code.
+
+### By asset and network (recommended)
 
 ```typescript
 const withdrawal = await sdk.requestWithdrawal('WALLET_ID', {
-  assetId: 'ASSET_UUID',
+  asset: 'ETH',
+  network: 'ETHEREUM_MAINNET',
   amount: '10.5',
   recipientAddress: '0xRecipientAddress',
   notes: 'Monthly payout'
@@ -117,6 +140,17 @@ console.log('Withdrawal ID:', withdrawal.withdrawal.id)
 console.log('Status:', withdrawal.withdrawal.status)
 ```
 
+### By asset ID
+
+```typescript
+const withdrawal = await sdk.requestWithdrawal('WALLET_ID', {
+  assetId: 'ASSET_UUID',
+  amount: '10.5',
+  recipientAddress: '0xRecipientAddress',
+  notes: 'Monthly payout'
+})
+```
+
 ## Create Onchain Transaction
 
 Sign and broadcast transactions directly on EVM or Solana networks using the built-in signers.
@@ -226,7 +260,7 @@ const isValid = await apiService.Webhook.verifyEvent(event, signature)
 
 ## Payment Processing
 
-Create checkouts and process crypto payments.
+Create checkouts and process crypto payments. You can specify accepted assets using `accepted_assets` (asset symbol + network code) or the legacy `supported_assets` format.
 
 ```typescript
 import { PaymentService, Environment } from '@fystack/sdk'
@@ -239,7 +273,11 @@ const paymentService = new PaymentService({
 const checkout = await paymentService.createCheckout({
   price: '10.50',
   currency: 'USD',
-  supported_assets: ['SOL:1399811149', 'USDC:1399811149'],
+  accepted_assets: [
+    { asset: 'SOL', network: 'SOL_MAINNET' },
+    { asset: 'ETH', network: 'ETHEREUM_MAINNET' },
+    { asset: 'ETH', network: 'BASE_MAINNET' },
+  ],
   description: 'Premium subscription',
   success_url: 'https://yourapp.com/success',
   cancel_url: 'https://yourapp.com/cancel',
@@ -249,3 +287,14 @@ const checkout = await paymentService.createCheckout({
 
 console.log('Checkout URL:', checkout.id)
 ```
+
+### Self-Hosted
+
+```typescript
+import { PaymentService } from '@fystack/sdk'
+
+const paymentService = new PaymentService({
+  apiKey: 'YOUR_API_KEY',
+  domain: 'api.your-company.com'
+})
+```

package/src/api.ts

@@ -67,7 +67,8 @@ export interface CreateWalletPayload {
 
 export interface PaymentServiceParams {
   apiKey: string
-  environment: Environment
+  environment?: Environment
+  domain?: string
 }
 
 async function composeAPIHeaders(
@@ -115,10 +116,10 @@ export class APIService {
   public Webhook: WebhookService
   private API: APIConfig
 
-  constructor(credentials: APICredentials, environment: Environment) {
+  constructor(credentials: APICredentials, environment?: Environment, domain?: string) {
     this.credentials = credentials
     this.Webhook = new WebhookService(credentials)
-    this.API = createAPI(environment)
+    this.API = createAPI(environment, domain)
   }
 
   async getWallets(workspaceId: string): Promise<WalletByWorkspaceResponse[]> {
@@ -285,7 +286,7 @@ export class PaymentService {
 
   constructor(params: PaymentServiceParams) {
     this.apiKey = params.apiKey
-    this.API = createAPI(params.environment)
+    this.API = createAPI(params.environment, params.domain)
   }
 
   async createCheckout(payload: CreateCheckoutPayload): Promise<CreateCheckoutResponse> {
@@ -427,7 +428,9 @@ export function transformRescanTransactionParams(data: RescanTransactionParams)
 
 export function transformRequestWithdrawalParams(data: RequestWithdrawalParams) {
   return {
-    asset_id: data.assetId,
+    ...(data.assetId !== undefined && { asset_id: data.assetId }),
+    ...(data.network !== undefined && { network: data.network }),
+    ...(data.asset !== undefined && { asset: data.asset }),
     amount: data.amount,
     recipient_address: data.recipientAddress,
     ...(data.notes !== undefined && { notes: data.notes }),

package/src/config.ts

@@ -33,7 +33,7 @@ const getBaseURL = (env: Environment): string => {
     case Environment.Sandbox:
       return 'https://api-dev.fystack.io'
     case Environment.Production:
-      return 'https://fystack.excelon.io'
+      return 'https://api.fystack.io'
   }
 }
 
@@ -42,8 +42,23 @@ export interface APIConfig {
   endpoints: APIEndpoints
 }
 
-const createAPI = (env: Environment): APIConfig => {
-  const baseURL = `${getBaseURL(env)}/api/v1`
+function validateDomain(domain: string): void {
+  const domainPattern = /^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/
+  if (!domainPattern.test(domain)) {
+    throw new Error(`Invalid domain: "${domain}". Expected a valid domain like "api.example.com"`)
+  }
+}
+
+const createAPI = (env?: Environment, domain?: string): APIConfig => {
+  let baseURL: string
+  if (domain) {
+    validateDomain(domain)
+    baseURL = `https://${domain}/api/v1`
+  } else if (env) {
+    baseURL = `${getBaseURL(env)}/api/v1`
+  } else {
+    baseURL = `${getBaseURL(Environment.Production)}/api/v1`
+  }
 
   const withBaseURL = (path: string) => `${baseURL}${path}`
 

package/src/payment.ts

@@ -33,10 +33,16 @@ export interface Asset {
   network_id: string
   network?: Network
 }
+export interface AcceptedAsset {
+  asset: string
+  network: string
+}
+
 export interface CreateCheckoutPayload {
   price: string
   currency: string
-  supported_assets: string[]
+  supported_assets?: string[]
+  accepted_assets?: AcceptedAsset[]
   underpaid_cover_percent?: number
   description?: string
   success_url?: string

package/src/sdk.ts

@@ -23,6 +23,7 @@ export interface SDKOptions {
   credentials: APICredentials
   workspaceId?: string
   environment?: Environment
+  domain?: string
   /** Enable debug logging. Defaults to false */
   debug?: boolean
 }
@@ -39,9 +40,10 @@ export class FystackSDK {
       credentials,
       workspaceId,
       environment = Environment.Production,
+      domain,
       debug = false
     } = options
-    this.apiService = new APIService(credentials, environment)
+    this.apiService = new APIService(credentials, environment, domain)
     this.debugEnabled = debug
     this.workspaceId = workspaceId
     this.automation = new AutomationNamespace(this)
@@ -204,7 +206,11 @@ export class FystackSDK {
     params: RequestWithdrawalParams
   ): Promise<RequestWithdrawalResponse> {
     validateUUID(walletId, 'walletId')
-    validateUUID(params.assetId, 'assetId')
+    if (params.assetId) {
+      validateUUID(params.assetId, 'assetId')
+    } else if (!params.asset || !params.network) {
+      throw new Error('Either assetId or both asset and network must be provided')
+    }
 
     if (!params.amount || params.amount.trim() === '') {
       throw new Error('Invalid amount provided')

package/src/types.ts

@@ -179,7 +179,9 @@ export interface WalletByWorkspaceResponse {
 }
 
 export interface RequestWithdrawalParams {
-  assetId: string
+  assetId?: string
+  network?: string
+  asset?: string
   amount: string
   recipientAddress: string
   notes?: string