@fenelabs/fene-sdk 0.3.8 → 0.5.0

package/dist/index.d.mts

@@ -19,7 +19,7 @@ interface AuthVerifyRequest {
 }
 interface AuthResponse {
     token: string;
-    role: 'validator' | 'delegator';
+    role: "validator" | "delegator";
     expires_at: number;
 }
 declare enum ValidatorStatus {
@@ -102,7 +102,7 @@ interface GeoNode {
     country: string;
     country_code: string;
     last_seen: string;
-    node_type: 'validator' | 'rpc' | 'bootstrap';
+    node_type: "validator" | "rpc" | "bootstrap";
     online: boolean;
 }
 interface GeoStats {
@@ -124,6 +124,8 @@ interface NetworkStats {
     current_block: number;
     epoch: number;
     block_time: number;
+    min_stake_delegator: string;
+    min_stake_validator: string;
 }
 interface EpochInfo {
     number: number;
@@ -162,6 +164,42 @@ interface RewardHistory {
     amount: string;
     timestamp: string;
 }
+interface Transaction {
+    id: number;
+    tx_hash: string;
+    block_number: number;
+    from_address: string;
+    to_address: string;
+    method_name: string;
+    method_selector: string;
+    value: string;
+    gas_used: number;
+    timestamp: number;
+    status: string;
+}
+interface TransactionsList {
+    transactions: Transaction[];
+    total: number;
+    page: number;
+    limit: number;
+}
+interface TransactionStats {
+    total_24h: number;
+    gas_used_24h: number;
+}
+interface TransactionsParams {
+    page?: number;
+    limit?: number;
+    method?: string;
+    address?: string;
+    sort?: "asc" | "desc";
+}
+interface PriceResponse {
+    price: number;
+    currency: string;
+    provider: string;
+    updated_at: number;
+}
 
 interface RequestContext {
     method: string;
@@ -207,6 +245,7 @@ declare class ResonanceClient {
     private onRequest?;
     private onResponse?;
     private onError?;
+    private isRefreshing;
     constructor(config?: ResonanceClientConfig);
     setToken(token: string): void;
     clearToken(): void;
@@ -214,6 +253,19 @@ declare class ResonanceClient {
     private executeRequest;
     getNonce(address: Address): Promise<NonceResponse>;
     verify(params: AuthVerifyRequest): Promise<AuthResponse>;
+    /**
+     * Refresh the access token using the refresh token cookie.
+     * Returns true if refresh was successful.
+     */
+    refresh(): Promise<boolean>;
+    /**
+     * Logout and revoke current session.
+     */
+    logout(): Promise<void>;
+    /**
+     * Logout from all devices.
+     */
+    logoutAll(): Promise<void>;
     getValidators(): Promise<ValidatorSummary[]>;
     getActiveValidators(): Promise<ValidatorSummary[]>;
     getCandidates(): Promise<ValidatorSummary[]>;
@@ -237,6 +289,9 @@ declare class ResonanceClient {
     getAvatar(address: Address): Promise<AvatarResponse>;
     getDailyBlockStats(days?: number): Promise<DailyBlockStats[]>;
     getValidatorRewardHistory(address: Address, limit?: number): Promise<RewardHistory[]>;
+    getTransactions(params?: TransactionsParams): Promise<TransactionsList>;
+    getTransactionStats(): Promise<TransactionStats>;
+    getCoinPrice(): Promise<PriceResponse>;
 }
 declare function createResonanceClient(config: ResonanceClientConfig): ResonanceClient;
 
@@ -320,4 +375,4 @@ declare class EventBus {
 }
 declare const eventBus: EventBus;
 
-export { type APIErrorResponse, type Address, type AuthResponse, type AuthVerifyRequest, type AvatarResponse, type DailyBlockStats, type Delegator, type DelegatorRewards, type DelegatorStake, DelegatorStatus, type EpochInfo, ErrorCode, type ErrorCodeType, type GeoNode, type GeoStats, type GeoUpdateRequest, type NetworkAPR, type NetworkStats, type NonceResponse, type PaginatedResponse, type ReferralKey, type RequestContext, ResonanceClient, type ResonanceClientConfig, ResonanceError, type ResponseContext, type RewardHistory, type UploadResponse, type Validator, type ValidatorAPR, ValidatorStatus, type ValidatorSummary, type WhitelistCheckRequest, type WhitelistCheckResponse, createResonanceClient, eventBus, hasErrorCode, isAuthError, isNetworkError, isNotFoundError, isResonanceError };
+export { type APIErrorResponse, type Address, type AuthResponse, type AuthVerifyRequest, type AvatarResponse, type DailyBlockStats, type Delegator, type DelegatorRewards, type DelegatorStake, DelegatorStatus, type EpochInfo, ErrorCode, type ErrorCodeType, type GeoNode, type GeoStats, type GeoUpdateRequest, type NetworkAPR, type NetworkStats, type NonceResponse, type PaginatedResponse, type PriceResponse, type ReferralKey, type RequestContext, ResonanceClient, type ResonanceClientConfig, ResonanceError, type ResponseContext, type RewardHistory, type Transaction, type TransactionStats, type TransactionsList, type TransactionsParams, type UploadResponse, type Validator, type ValidatorAPR, ValidatorStatus, type ValidatorSummary, type WhitelistCheckRequest, type WhitelistCheckResponse, createResonanceClient, eventBus, hasErrorCode, isAuthError, isNetworkError, isNotFoundError, isResonanceError };

package/dist/index.d.ts

@@ -19,7 +19,7 @@ interface AuthVerifyRequest {
 }
 interface AuthResponse {
     token: string;
-    role: 'validator' | 'delegator';
+    role: "validator" | "delegator";
     expires_at: number;
 }
 declare enum ValidatorStatus {
@@ -102,7 +102,7 @@ interface GeoNode {
     country: string;
     country_code: string;
     last_seen: string;
-    node_type: 'validator' | 'rpc' | 'bootstrap';
+    node_type: "validator" | "rpc" | "bootstrap";
     online: boolean;
 }
 interface GeoStats {
@@ -124,6 +124,8 @@ interface NetworkStats {
     current_block: number;
     epoch: number;
     block_time: number;
+    min_stake_delegator: string;
+    min_stake_validator: string;
 }
 interface EpochInfo {
     number: number;
@@ -162,6 +164,42 @@ interface RewardHistory {
     amount: string;
     timestamp: string;
 }
+interface Transaction {
+    id: number;
+    tx_hash: string;
+    block_number: number;
+    from_address: string;
+    to_address: string;
+    method_name: string;
+    method_selector: string;
+    value: string;
+    gas_used: number;
+    timestamp: number;
+    status: string;
+}
+interface TransactionsList {
+    transactions: Transaction[];
+    total: number;
+    page: number;
+    limit: number;
+}
+interface TransactionStats {
+    total_24h: number;
+    gas_used_24h: number;
+}
+interface TransactionsParams {
+    page?: number;
+    limit?: number;
+    method?: string;
+    address?: string;
+    sort?: "asc" | "desc";
+}
+interface PriceResponse {
+    price: number;
+    currency: string;
+    provider: string;
+    updated_at: number;
+}
 
 interface RequestContext {
     method: string;
@@ -207,6 +245,7 @@ declare class ResonanceClient {
     private onRequest?;
     private onResponse?;
     private onError?;
+    private isRefreshing;
     constructor(config?: ResonanceClientConfig);
     setToken(token: string): void;
     clearToken(): void;
@@ -214,6 +253,19 @@ declare class ResonanceClient {
     private executeRequest;
     getNonce(address: Address): Promise<NonceResponse>;
     verify(params: AuthVerifyRequest): Promise<AuthResponse>;
+    /**
+     * Refresh the access token using the refresh token cookie.
+     * Returns true if refresh was successful.
+     */
+    refresh(): Promise<boolean>;
+    /**
+     * Logout and revoke current session.
+     */
+    logout(): Promise<void>;
+    /**
+     * Logout from all devices.
+     */
+    logoutAll(): Promise<void>;
     getValidators(): Promise<ValidatorSummary[]>;
     getActiveValidators(): Promise<ValidatorSummary[]>;
     getCandidates(): Promise<ValidatorSummary[]>;
@@ -237,6 +289,9 @@ declare class ResonanceClient {
     getAvatar(address: Address): Promise<AvatarResponse>;
     getDailyBlockStats(days?: number): Promise<DailyBlockStats[]>;
     getValidatorRewardHistory(address: Address, limit?: number): Promise<RewardHistory[]>;
+    getTransactions(params?: TransactionsParams): Promise<TransactionsList>;
+    getTransactionStats(): Promise<TransactionStats>;
+    getCoinPrice(): Promise<PriceResponse>;
 }
 declare function createResonanceClient(config: ResonanceClientConfig): ResonanceClient;
 
@@ -320,4 +375,4 @@ declare class EventBus {
 }
 declare const eventBus: EventBus;
 
-export { type APIErrorResponse, type Address, type AuthResponse, type AuthVerifyRequest, type AvatarResponse, type DailyBlockStats, type Delegator, type DelegatorRewards, type DelegatorStake, DelegatorStatus, type EpochInfo, ErrorCode, type ErrorCodeType, type GeoNode, type GeoStats, type GeoUpdateRequest, type NetworkAPR, type NetworkStats, type NonceResponse, type PaginatedResponse, type ReferralKey, type RequestContext, ResonanceClient, type ResonanceClientConfig, ResonanceError, type ResponseContext, type RewardHistory, type UploadResponse, type Validator, type ValidatorAPR, ValidatorStatus, type ValidatorSummary, type WhitelistCheckRequest, type WhitelistCheckResponse, createResonanceClient, eventBus, hasErrorCode, isAuthError, isNetworkError, isNotFoundError, isResonanceError };
+export { type APIErrorResponse, type Address, type AuthResponse, type AuthVerifyRequest, type AvatarResponse, type DailyBlockStats, type Delegator, type DelegatorRewards, type DelegatorStake, DelegatorStatus, type EpochInfo, ErrorCode, type ErrorCodeType, type GeoNode, type GeoStats, type GeoUpdateRequest, type NetworkAPR, type NetworkStats, type NonceResponse, type PaginatedResponse, type PriceResponse, type ReferralKey, type RequestContext, ResonanceClient, type ResonanceClientConfig, ResonanceError, type ResponseContext, type RewardHistory, type Transaction, type TransactionStats, type TransactionsList, type TransactionsParams, type UploadResponse, type Validator, type ValidatorAPR, ValidatorStatus, type ValidatorSummary, type WhitelistCheckRequest, type WhitelistCheckResponse, createResonanceClient, eventBus, hasErrorCode, isAuthError, isNetworkError, isNotFoundError, isResonanceError };

package/dist/index.js

@@ -176,6 +176,7 @@ function getEnv(key) {
 }
 var ResonanceClient = class {
   constructor(config = {}) {
+    this.isRefreshing = false;
     validateConfig(config);
     const defaultUrl = "http://localhost:8080";
     const envUrl = getEnv(ENV_API_URL);
@@ -255,8 +256,17 @@ var ResonanceClient = class {
       });
       clearTimeout(timeoutId);
       const duration = Date.now() - startTime;
-      if (response.status === 401) {
-        eventBus.emit("api:unauthorized", { url, method: options.method || "GET" });
+      if (response.status === 401 && !this.isRefreshing) {
+        this.isRefreshing = true;
+        const refreshed = await this.refresh();
+        this.isRefreshing = false;
+        if (refreshed) {
+          return this.executeRequest(path, options, attemptNumber);
+        }
+        eventBus.emit("api:unauthorized", {
+          url,
+          method: options.method || "GET"
+        });
         this.onTokenExpired?.();
       }
       if (!response.ok) {
@@ -328,7 +338,7 @@ var ResonanceClient = class {
     return this.request(`/eth/v1/auth/nonce?address=${address}`);
   }
   async verify(params) {
-    const result = await this.request("/eth/v1/auth/verify", {
+    return this.request("/eth/v1/auth/verify", {
       method: "POST",
       body: JSON.stringify({
         address: params.address,
@@ -336,8 +346,55 @@ var ResonanceClient = class {
         nonce: params.nonce
       })
     });
-    this.token = result.token;
-    return result;
+  }
+  /**
+   * Refresh the access token using the refresh token cookie.
+   * Returns true if refresh was successful.
+   */
+  async refresh() {
+    try {
+      const response = await fetch(`${this.baseUrl}/eth/v1/auth/refresh`, {
+        method: "POST",
+        credentials: "include",
+        // Send refresh_token cookie
+        headers: { "Content-Type": "application/json" }
+      });
+      if (response.ok) {
+        const data = await response.json();
+        return data.success === true;
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Logout and revoke current session.
+   */
+  async logout() {
+    try {
+      await fetch(`${this.baseUrl}/eth/v1/auth/logout`, {
+        method: "POST",
+        credentials: "include",
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch {
+    }
+    this.token = void 0;
+  }
+  /**
+   * Logout from all devices.
+   */
+  async logoutAll() {
+    try {
+      await fetch(`${this.baseUrl}/eth/v1/auth/logout-all`, {
+        method: "POST",
+        credentials: "include",
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch {
+    }
+    this.token = void 0;
   }
   // ============================================
   // Validators
@@ -453,6 +510,28 @@ var ResonanceClient = class {
   async getValidatorRewardHistory(address, limit = 100) {
     return this.request(`/eth/v1/analytics/rewards/${address}?limit=${limit}`);
   }
+  // ============================================
+  // Transactions (NEW)
+  // ============================================
+  async getTransactions(params = {}) {
+    const queryParams = new URLSearchParams();
+    if (params.page) queryParams.set("page", params.page.toString());
+    if (params.limit) queryParams.set("limit", params.limit.toString());
+    if (params.method) queryParams.set("method", params.method);
+    if (params.address) queryParams.set("address", params.address);
+    if (params.sort) queryParams.set("sort", params.sort);
+    const query = queryParams.toString();
+    return this.request(`/eth/v1/transactions${query ? `?${query}` : ""}`);
+  }
+  async getTransactionStats() {
+    return this.request("/eth/v1/transactions/stats");
+  }
+  // ============================================
+  // Price (NEW)
+  // ============================================
+  async getCoinPrice() {
+    return this.request("/eth/v1/price");
+  }
 };
 function createResonanceClient(config) {
   return new ResonanceClient(config);

package/dist/index.mjs

@@ -140,6 +140,7 @@ function getEnv(key) {
 }
 var ResonanceClient = class {
   constructor(config = {}) {
+    this.isRefreshing = false;
     validateConfig(config);
     const defaultUrl = "http://localhost:8080";
     const envUrl = getEnv(ENV_API_URL);
@@ -219,8 +220,17 @@ var ResonanceClient = class {
       });
       clearTimeout(timeoutId);
       const duration = Date.now() - startTime;
-      if (response.status === 401) {
-        eventBus.emit("api:unauthorized", { url, method: options.method || "GET" });
+      if (response.status === 401 && !this.isRefreshing) {
+        this.isRefreshing = true;
+        const refreshed = await this.refresh();
+        this.isRefreshing = false;
+        if (refreshed) {
+          return this.executeRequest(path, options, attemptNumber);
+        }
+        eventBus.emit("api:unauthorized", {
+          url,
+          method: options.method || "GET"
+        });
         this.onTokenExpired?.();
       }
       if (!response.ok) {
@@ -292,7 +302,7 @@ var ResonanceClient = class {
     return this.request(`/eth/v1/auth/nonce?address=${address}`);
   }
   async verify(params) {
-    const result = await this.request("/eth/v1/auth/verify", {
+    return this.request("/eth/v1/auth/verify", {
       method: "POST",
       body: JSON.stringify({
         address: params.address,
@@ -300,8 +310,55 @@ var ResonanceClient = class {
         nonce: params.nonce
       })
     });
-    this.token = result.token;
-    return result;
+  }
+  /**
+   * Refresh the access token using the refresh token cookie.
+   * Returns true if refresh was successful.
+   */
+  async refresh() {
+    try {
+      const response = await fetch(`${this.baseUrl}/eth/v1/auth/refresh`, {
+        method: "POST",
+        credentials: "include",
+        // Send refresh_token cookie
+        headers: { "Content-Type": "application/json" }
+      });
+      if (response.ok) {
+        const data = await response.json();
+        return data.success === true;
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Logout and revoke current session.
+   */
+  async logout() {
+    try {
+      await fetch(`${this.baseUrl}/eth/v1/auth/logout`, {
+        method: "POST",
+        credentials: "include",
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch {
+    }
+    this.token = void 0;
+  }
+  /**
+   * Logout from all devices.
+   */
+  async logoutAll() {
+    try {
+      await fetch(`${this.baseUrl}/eth/v1/auth/logout-all`, {
+        method: "POST",
+        credentials: "include",
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch {
+    }
+    this.token = void 0;
   }
   // ============================================
   // Validators
@@ -417,6 +474,28 @@ var ResonanceClient = class {
   async getValidatorRewardHistory(address, limit = 100) {
     return this.request(`/eth/v1/analytics/rewards/${address}?limit=${limit}`);
   }
+  // ============================================
+  // Transactions (NEW)
+  // ============================================
+  async getTransactions(params = {}) {
+    const queryParams = new URLSearchParams();
+    if (params.page) queryParams.set("page", params.page.toString());
+    if (params.limit) queryParams.set("limit", params.limit.toString());
+    if (params.method) queryParams.set("method", params.method);
+    if (params.address) queryParams.set("address", params.address);
+    if (params.sort) queryParams.set("sort", params.sort);
+    const query = queryParams.toString();
+    return this.request(`/eth/v1/transactions${query ? `?${query}` : ""}`);
+  }
+  async getTransactionStats() {
+    return this.request("/eth/v1/transactions/stats");
+  }
+  // ============================================
+  // Price (NEW)
+  // ============================================
+  async getCoinPrice() {
+    return this.request("/eth/v1/price");
+  }
 };
 function createResonanceClient(config) {
   return new ResonanceClient(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenelabs/fene-sdk",
-  "version": "0.3.8",
+  "version": "0.5.0",
   "description": "TypeScript SDK for Fene API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",