@fenelabs/fene-sdk 0.4.0 → 0.7.1

package/dist/index.d.mts

@@ -19,9 +19,13 @@ interface AuthVerifyRequest {
 }
 interface AuthResponse {
     token: string;
-    role: 'validator' | 'delegator';
+    role: "validator" | "delegator";
     expires_at: number;
 }
+interface RefreshResponse {
+    success: boolean;
+    expires_at?: number;
+}
 declare enum ValidatorStatus {
     NOT_EXIST = 0,
     CREATED = 1,
@@ -95,15 +99,13 @@ interface WhitelistCheckResponse {
 }
 interface GeoNode {
     address: string;
-    ip: string;
-    latitude: number;
-    longitude: number;
-    city: string;
+    role: "validator" | "delegator";
+    lat: number;
+    lng: number;
     country: string;
-    country_code: string;
-    last_seen: string;
-    node_type: 'validator' | 'rpc' | 'bootstrap';
+    city?: string;
     online: boolean;
+    last_seen: number;
 }
 interface GeoStats {
     total_nodes: number;
@@ -112,9 +114,51 @@ interface GeoStats {
     cities: number;
 }
 interface GeoUpdateRequest {
+    lat: number;
+    lng: number;
+}
+interface GeoAutoDetectResponse {
+    success: boolean;
+    address: string;
+    role: "validator" | "delegator";
     latitude: number;
     longitude: number;
-    node_type: string;
+    country: string;
+    city: string;
+    is_online: boolean;
+}
+interface UserProfile {
+    address: string;
+    roles: ("validator" | "delegator")[];
+    validator?: ValidatorProfileInfo;
+    delegations?: DelegationInfo[];
+    total_delegation_stake: string;
+    total_pending_rewards: string;
+    avatar_url?: string;
+    geo?: GeoLocation;
+}
+interface ValidatorProfileInfo {
+    address: string;
+    moniker: string;
+    self_stake: string;
+    total_stake: string;
+    commission_rate: number;
+    delegator_count: number;
+    claimable_reward: string;
+    apr: number;
+}
+interface DelegationInfo {
+    validator_address: string;
+    validator_moniker: string;
+    stake_amount: string;
+    pending_rewards: string;
+    apr: number;
+}
+interface GeoLocation {
+    lat: number;
+    lng: number;
+    country: string;
+    city?: string;
 }
 interface NetworkStats {
     total_validators: number;
@@ -124,6 +168,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 +208,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;
@@ -217,9 +299,9 @@ declare class ResonanceClient {
     verify(params: AuthVerifyRequest): Promise<AuthResponse>;
     /**
      * Refresh the access token using the refresh token cookie.
-     * Returns true if refresh was successful.
+     * Returns { success: boolean, expires_at?: number }
      */
-    refresh(): Promise<boolean>;
+    refresh(): Promise<RefreshResponse>;
     /**
      * Logout and revoke current session.
      */
@@ -239,10 +321,30 @@ declare class ResonanceClient {
     getReferralKey(key: string): Promise<ReferralKey>;
     getValidatorKeys(address: Address): Promise<ReferralKey[]>;
     checkWhitelist(data: WhitelistCheckRequest): Promise<WhitelistCheckResponse>;
-    getGeoNodes(): Promise<GeoNode[]>;
-    getGeoValidators(): Promise<GeoNode[]>;
+    /**
+     * Get user profile with roles, validator info, delegations, avatar, and geo
+     * @param address The user wallet address
+     */
+    getUserProfile(address: Address): Promise<UserProfile>;
+    /**
+     * Get user avatar URL
+     * @param address The user wallet address
+     */
+    getUserAvatar(address: Address): Promise<{
+        url: string;
+    }>;
+    /**
+     * Get all geo nodes, optionally filtered by role
+     * @param role Optional filter: "validator" or "delegator"
+     */
+    getGeoNodes(role?: "validator" | "delegator"): Promise<GeoNode[]>;
     getGeoStats(): Promise<GeoStats>;
     updateGeoLocation(data: GeoUpdateRequest): Promise<void>;
+    /**
+     * Auto-detect user geo location from IP and save to server.
+     * Should be called after successful login.
+     */
+    autoDetectGeo(): Promise<GeoAutoDetectResponse>;
     getNetworkStats(): Promise<NetworkStats>;
     getCurrentEpoch(): Promise<EpochInfo>;
     getNetworkAPR(): Promise<NetworkAPR>;
@@ -251,6 +353,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;
 
@@ -334,4 +439,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 RefreshResponse, 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,9 +19,13 @@ interface AuthVerifyRequest {
 }
 interface AuthResponse {
     token: string;
-    role: 'validator' | 'delegator';
+    role: "validator" | "delegator";
     expires_at: number;
 }
+interface RefreshResponse {
+    success: boolean;
+    expires_at?: number;
+}
 declare enum ValidatorStatus {
     NOT_EXIST = 0,
     CREATED = 1,
@@ -95,15 +99,13 @@ interface WhitelistCheckResponse {
 }
 interface GeoNode {
     address: string;
-    ip: string;
-    latitude: number;
-    longitude: number;
-    city: string;
+    role: "validator" | "delegator";
+    lat: number;
+    lng: number;
     country: string;
-    country_code: string;
-    last_seen: string;
-    node_type: 'validator' | 'rpc' | 'bootstrap';
+    city?: string;
     online: boolean;
+    last_seen: number;
 }
 interface GeoStats {
     total_nodes: number;
@@ -112,9 +114,51 @@ interface GeoStats {
     cities: number;
 }
 interface GeoUpdateRequest {
+    lat: number;
+    lng: number;
+}
+interface GeoAutoDetectResponse {
+    success: boolean;
+    address: string;
+    role: "validator" | "delegator";
     latitude: number;
     longitude: number;
-    node_type: string;
+    country: string;
+    city: string;
+    is_online: boolean;
+}
+interface UserProfile {
+    address: string;
+    roles: ("validator" | "delegator")[];
+    validator?: ValidatorProfileInfo;
+    delegations?: DelegationInfo[];
+    total_delegation_stake: string;
+    total_pending_rewards: string;
+    avatar_url?: string;
+    geo?: GeoLocation;
+}
+interface ValidatorProfileInfo {
+    address: string;
+    moniker: string;
+    self_stake: string;
+    total_stake: string;
+    commission_rate: number;
+    delegator_count: number;
+    claimable_reward: string;
+    apr: number;
+}
+interface DelegationInfo {
+    validator_address: string;
+    validator_moniker: string;
+    stake_amount: string;
+    pending_rewards: string;
+    apr: number;
+}
+interface GeoLocation {
+    lat: number;
+    lng: number;
+    country: string;
+    city?: string;
 }
 interface NetworkStats {
     total_validators: number;
@@ -124,6 +168,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 +208,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;
@@ -217,9 +299,9 @@ declare class ResonanceClient {
     verify(params: AuthVerifyRequest): Promise<AuthResponse>;
     /**
      * Refresh the access token using the refresh token cookie.
-     * Returns true if refresh was successful.
+     * Returns { success: boolean, expires_at?: number }
      */
-    refresh(): Promise<boolean>;
+    refresh(): Promise<RefreshResponse>;
     /**
      * Logout and revoke current session.
      */
@@ -239,10 +321,30 @@ declare class ResonanceClient {
     getReferralKey(key: string): Promise<ReferralKey>;
     getValidatorKeys(address: Address): Promise<ReferralKey[]>;
     checkWhitelist(data: WhitelistCheckRequest): Promise<WhitelistCheckResponse>;
-    getGeoNodes(): Promise<GeoNode[]>;
-    getGeoValidators(): Promise<GeoNode[]>;
+    /**
+     * Get user profile with roles, validator info, delegations, avatar, and geo
+     * @param address The user wallet address
+     */
+    getUserProfile(address: Address): Promise<UserProfile>;
+    /**
+     * Get user avatar URL
+     * @param address The user wallet address
+     */
+    getUserAvatar(address: Address): Promise<{
+        url: string;
+    }>;
+    /**
+     * Get all geo nodes, optionally filtered by role
+     * @param role Optional filter: "validator" or "delegator"
+     */
+    getGeoNodes(role?: "validator" | "delegator"): Promise<GeoNode[]>;
     getGeoStats(): Promise<GeoStats>;
     updateGeoLocation(data: GeoUpdateRequest): Promise<void>;
+    /**
+     * Auto-detect user geo location from IP and save to server.
+     * Should be called after successful login.
+     */
+    autoDetectGeo(): Promise<GeoAutoDetectResponse>;
     getNetworkStats(): Promise<NetworkStats>;
     getCurrentEpoch(): Promise<EpochInfo>;
     getNetworkAPR(): Promise<NetworkAPR>;
@@ -251,6 +353,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;
 
@@ -334,4 +439,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 RefreshResponse, 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

@@ -263,7 +263,10 @@ var ResonanceClient = class {
         if (refreshed) {
           return this.executeRequest(path, options, attemptNumber);
         }
-        eventBus.emit("api:unauthorized", { url, method: options.method || "GET" });
+        eventBus.emit("api:unauthorized", {
+          url,
+          method: options.method || "GET"
+        });
         this.onTokenExpired?.();
       }
       if (!response.ok) {
@@ -346,7 +349,7 @@ var ResonanceClient = class {
   }
   /**
    * Refresh the access token using the refresh token cookie.
-   * Returns true if refresh was successful.
+   * Returns { success: boolean, expires_at?: number }
    */
   async refresh() {
     try {
@@ -358,11 +361,14 @@ var ResonanceClient = class {
       });
       if (response.ok) {
         const data = await response.json();
-        return data.success === true;
+        return {
+          success: data.success === true,
+          expires_at: data.expires_at
+        };
       }
-      return false;
+      return { success: false };
     } catch {
-      return false;
+      return { success: false };
     }
   }
   /**
@@ -439,13 +445,32 @@ var ResonanceClient = class {
     });
   }
   // ============================================
-  // Geo
+  // User Profile
   // ============================================
-  async getGeoNodes() {
-    return this.request("/eth/v1/geo/nodes");
+  /**
+   * Get user profile with roles, validator info, delegations, avatar, and geo
+   * @param address The user wallet address
+   */
+  async getUserProfile(address) {
+    return this.request(`/eth/v1/user/${address}/profile`);
+  }
+  /**
+   * Get user avatar URL
+   * @param address The user wallet address
+   */
+  async getUserAvatar(address) {
+    return this.request(`/eth/v1/user/${address}/avatar`);
   }
-  async getGeoValidators() {
-    return this.request("/eth/v1/geo/validators");
+  // ============================================
+  // Geo
+  // ============================================
+  /**
+   * Get all geo nodes, optionally filtered by role
+   * @param role Optional filter: "validator" or "delegator"
+   */
+  async getGeoNodes(role) {
+    const params = role ? `?role=${role}` : "";
+    return this.request(`/eth/v1/geo/nodes${params}`);
   }
   async getGeoStats() {
     return this.request("/eth/v1/geo/stats");
@@ -456,6 +481,15 @@ var ResonanceClient = class {
       body: JSON.stringify(data)
     });
   }
+  /**
+   * Auto-detect user geo location from IP and save to server.
+   * Should be called after successful login.
+   */
+  async autoDetectGeo() {
+    return this.request("/eth/v1/geo/auto-detect", {
+      method: "POST"
+    });
+  }
   // ============================================
   // Stats
   // ============================================
@@ -507,6 +541,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

@@ -227,7 +227,10 @@ var ResonanceClient = class {
         if (refreshed) {
           return this.executeRequest(path, options, attemptNumber);
         }
-        eventBus.emit("api:unauthorized", { url, method: options.method || "GET" });
+        eventBus.emit("api:unauthorized", {
+          url,
+          method: options.method || "GET"
+        });
         this.onTokenExpired?.();
       }
       if (!response.ok) {
@@ -310,7 +313,7 @@ var ResonanceClient = class {
   }
   /**
    * Refresh the access token using the refresh token cookie.
-   * Returns true if refresh was successful.
+   * Returns { success: boolean, expires_at?: number }
    */
   async refresh() {
     try {
@@ -322,11 +325,14 @@ var ResonanceClient = class {
       });
       if (response.ok) {
         const data = await response.json();
-        return data.success === true;
+        return {
+          success: data.success === true,
+          expires_at: data.expires_at
+        };
       }
-      return false;
+      return { success: false };
     } catch {
-      return false;
+      return { success: false };
     }
   }
   /**
@@ -403,13 +409,32 @@ var ResonanceClient = class {
     });
   }
   // ============================================
-  // Geo
+  // User Profile
   // ============================================
-  async getGeoNodes() {
-    return this.request("/eth/v1/geo/nodes");
+  /**
+   * Get user profile with roles, validator info, delegations, avatar, and geo
+   * @param address The user wallet address
+   */
+  async getUserProfile(address) {
+    return this.request(`/eth/v1/user/${address}/profile`);
+  }
+  /**
+   * Get user avatar URL
+   * @param address The user wallet address
+   */
+  async getUserAvatar(address) {
+    return this.request(`/eth/v1/user/${address}/avatar`);
   }
-  async getGeoValidators() {
-    return this.request("/eth/v1/geo/validators");
+  // ============================================
+  // Geo
+  // ============================================
+  /**
+   * Get all geo nodes, optionally filtered by role
+   * @param role Optional filter: "validator" or "delegator"
+   */
+  async getGeoNodes(role) {
+    const params = role ? `?role=${role}` : "";
+    return this.request(`/eth/v1/geo/nodes${params}`);
   }
   async getGeoStats() {
     return this.request("/eth/v1/geo/stats");
@@ -420,6 +445,15 @@ var ResonanceClient = class {
       body: JSON.stringify(data)
     });
   }
+  /**
+   * Auto-detect user geo location from IP and save to server.
+   * Should be called after successful login.
+   */
+  async autoDetectGeo() {
+    return this.request("/eth/v1/geo/auto-detect", {
+      method: "POST"
+    });
+  }
   // ============================================
   // Stats
   // ============================================
@@ -471,6 +505,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.4.0",
+  "version": "0.7.1",
   "description": "TypeScript SDK for Fene API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -20,6 +20,7 @@
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "lint": "tsc --noEmit",
     "test": "vitest run",
+    "watch": "esbuild src/app.ts --bundle --sourcemap --outdir=www --servedir=www --watch",
     "prepublishOnly": "pnpm run build"
   },
   "keywords": [
@@ -33,9 +34,17 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/fenelabs/fene-sdk"
+    "url": "https://github.com/fenelabs/fene-sdk.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "esbuild": ">=0.25.0"
   },
   "devDependencies": {
+    "esbuild": "^0.25.2",
     "@types/node": "^25.0.3",
     "tsup": "^8.0.0",
     "typescript": "^5.3.0",