@powersun/mcp-client 1.0.0

package/README.md

@@ -0,0 +1,117 @@
+# @powersun/mcp-client
+
+TypeScript SDK for [PowerSun.vip](https://powersun.vip) — the TRON Energy & Bandwidth marketplace for AI agents.
+
+## Install
+
+```bash
+npm install @powersun/mcp-client
+```
+
+## Quick Start
+
+```typescript
+import { PowerSun } from '@powersun/mcp-client';
+
+// Public access (market data, estimates)
+const ps = new PowerSun();
+const prices = await ps.market.getPrices();
+const estimate = await ps.market.estimateCost({
+  txCount: 10,
+  txType: 'trc20_transfer',
+  durationMinutes: 60,
+});
+
+// Authenticated access (buy energy, check balance)
+const client = new PowerSun({ apiKey: 'ps_your_key_here' });
+const balance = await client.buyer.getBalance();
+const order = await client.buyer.buyEnergy({
+  targetAddress: 'TYourAddressHere...',
+  txCount: 5,
+  durationMinutes: 60,
+});
+```
+
+## HTTP 402 Pay-per-use (No Registration)
+
+```typescript
+import { PowerSun, PaymentRequiredError } from '@powersun/mcp-client';
+
+const ps = new PowerSun(); // no API key
+
+try {
+  await ps.buyer.buyEnergy({
+    targetAddress: 'TYourAddressHere...',
+    txCount: 1,
+    durationMinutes: 5,
+  });
+} catch (err) {
+  if (err instanceof PaymentRequiredError) {
+    // Send TRX to the deposit address
+    console.log('Deposit address:', err.payment.depositAddress);
+    console.log('Amount (TRX):', err.payment.requiredAmountTrx);
+
+    // Poll for payment confirmation
+    const status = await ps.paymentStatus(err.payment.intentId);
+    console.log('Payment status:', status.status);
+  }
+}
+```
+
+## Registration
+
+```typescript
+const ps = new PowerSun();
+
+// Step 1: Get challenge
+const { challengeId, challenge } = await ps.register('TYourAddress...');
+
+// Step 2: Sign challenge with TronLink / tronWeb
+const signature = await tronWeb.trx.signMessageV2(challenge);
+
+// Step 3: Verify and get API key
+const { apiKey } = await ps.verify(challengeId, 'TYourAddress...', signature);
+
+// Step 4: Use authenticated client
+const client = new PowerSun({ apiKey });
+```
+
+## API Reference
+
+### `new PowerSun(config?)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | — | API key (`ps_*` format) |
+| `baseUrl` | `string` | `https://powersun.vip` | API base URL |
+| `timeout` | `number` | `30000` | Request timeout (ms) |
+
+### Market (public)
+
+- `ps.market.getPrices()` — Price tiers for all durations
+- `ps.market.estimateCost(params)` — Cost estimate
+- `ps.market.getAvailableResources()` — Available energy/bandwidth
+- `ps.market.getOverview()` — Full market snapshot
+
+### Buyer (auth required)
+
+- `ps.buyer.buyEnergy(params)` — Purchase energy
+- `ps.buyer.getBalance()` — Account balance
+- `ps.buyer.getOrderStatus(orderId)` — Order details
+- `ps.buyer.broadcast(params)` — Broadcast pre-signed tx
+
+### Registration (public)
+
+- `ps.register(address)` — Start registration
+- `ps.verify(challengeId, address, signature)` — Verify & get API key
+- `ps.paymentStatus(intentId)` — Check 402 payment status
+
+## Links
+
+- **Platform:** [powersun.vip](https://powersun.vip)
+- **MCP Server:** [powersun.vip/mcp](https://powersun.vip/mcp)
+- **API Docs:** [powersun.vip/api-docs](https://powersun.vip/api-docs)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,265 @@
+/** PowerSun SDK configuration */
+interface PowerSunConfig {
+    /** API key (format: ps_*). Required for authenticated endpoints. */
+    apiKey?: string;
+    /** Base URL of the PowerSun API. Default: https://powersun.vip */
+    baseUrl?: string;
+    /** Request timeout in ms. Default: 30000 */
+    timeout?: number;
+}
+interface PriceTier {
+    durationMinutes: number;
+    durationLabel: string;
+    energyPriceSun: number;
+    bandwidthPriceSun: number;
+}
+interface PricesResponse {
+    tiers: PriceTier[];
+    updatedAt: string;
+}
+interface EstimateCostParams {
+    energy?: number;
+    bandwidth?: number;
+    txCount?: number;
+    txType?: 'trc20_transfer' | 'trc20_transfer_new' | 'trc10_transfer' | 'contract_call';
+    durationMinutes?: 5 | 10 | 15 | 30 | 60 | 120 | 1440 | 10080;
+    resourceType?: 'ENERGY' | 'BANDWIDTH';
+}
+interface EstimateResponse {
+    estimate: {
+        txCount: number;
+        energyPerTx: number;
+        totalEnergyNeeded: number;
+        durationMinutes: number;
+        resourceType: string;
+    };
+    pricing: {
+        pricePerUnitSun: number;
+        totalCostSun: number;
+        totalCostTrx: number;
+        costPerTxTrx: number;
+        burnCostPerTxTrx: number;
+        savingsPercent: number;
+    };
+    constraints: {
+        minimumOrderSize: number;
+        allowedDurations: number[];
+        meetsMinimum: boolean;
+    };
+    balance?: {
+        currentTrx: number;
+        sufficient: boolean;
+        remainingAfterTrx: number;
+    };
+}
+interface AvailableResourcesResponse {
+    energy: {
+        total: number;
+        available: number;
+    };
+    bandwidth: {
+        total: number;
+        available: number;
+    };
+}
+interface MarketOverviewResponse {
+    prices: PriceTier[];
+    availability: AvailableResourcesResponse;
+    stats: {
+        totalOrders24h: number;
+        totalVolume24hTrx: number;
+        activePools: number;
+    };
+}
+interface BuyEnergyParams {
+    targetAddress: string;
+    txCount: number;
+    txType?: 'trc20_transfer' | 'trc20_transfer_new' | 'trc10_transfer' | 'contract_call';
+    durationMinutes?: 5 | 10 | 15 | 30 | 60 | 120 | 1440 | 10080;
+    resourceType?: 'ENERGY' | 'BANDWIDTH';
+    maxPriceTrx?: number;
+}
+interface OrderResponse {
+    order: {
+        orderId: string;
+        status: 'pending' | 'active' | 'completed' | 'failed';
+        targetAddress: string;
+        resourceType: string;
+        energyAmount: number;
+        durationMinutes: number;
+        totalCostTrx: number;
+        totalCostSun: number;
+        createdAt: string;
+        estimatedDelivery: string;
+    };
+    balance: {
+        previousTrx: number;
+        deductedTrx: number;
+        remainingTrx: number;
+    };
+    nextAction: {
+        action: string;
+        url: string;
+        pollIntervalSeconds: number;
+    };
+}
+interface PaymentRequiredResponse {
+    error: 'payment_required';
+    message: string;
+    payment: {
+        depositAddress: string;
+        requiredAmountTrx: number;
+        requiredAmountSun: number;
+        intentId: string;
+        expiresAt: string;
+        checkStatusUrl: string;
+        scheme: string;
+    };
+    x402?: {
+        scheme: string;
+        network: string;
+        asset: string;
+        maxAmountRequired: string;
+        payTo: string;
+        intentId: string;
+        expiresAt: string;
+    };
+}
+interface BalanceResponse {
+    address: string;
+    balanceTrx: number;
+    balanceSun: number;
+    estimatedCapacity: {
+        trc20Transfers: {
+            count: number;
+            atDuration: string;
+            pricePerTxTrx: number;
+        };
+    };
+    depositAddress: string;
+    depositInstructions: string;
+}
+interface OrderStatusResponse {
+    orderId: string;
+    status: 'pending' | 'active' | 'completed' | 'failed';
+    resourceType: string;
+    energyDelegated: number;
+    targetAddress: string;
+    durationMinutes: number;
+    totalCostTrx: number;
+    createdAt: string;
+    completedAt: string | null;
+    progress: {
+        totalSize: number;
+        filledSize: number;
+        percentFilled: number;
+        fillCount: number;
+    };
+    fills: Array<{
+        poolId: string;
+        filledSize: number;
+        status: string;
+        txHash: string;
+    }>;
+}
+interface PaymentStatusResponse {
+    status: 'pending' | 'success' | 'expired' | 'failed';
+    intentId: string;
+    confirmedAt: string | null;
+    order: {
+        orderId: string;
+        status: string;
+        targetAddress: string;
+    } | null;
+}
+interface BroadcastParams {
+    txData: {
+        txID: string;
+        raw_data: Record<string, unknown>;
+        raw_data_hex?: string;
+        signature?: string[];
+    };
+}
+interface BroadcastResponse {
+    orderId: string;
+    status: string;
+    txId: string;
+    resourceType: string;
+    energyDelegated: number;
+    costTrx: number;
+}
+interface RegisterResponse {
+    challenge: string;
+    challengeId: string;
+    expiresAt: string;
+}
+interface VerifyResponse {
+    apiKey: string;
+    address: string;
+}
+declare class PowerSunError extends Error {
+    status: number;
+    code?: string | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, status: number, code?: string | undefined, details?: unknown | undefined);
+}
+declare class PaymentRequiredError extends PowerSunError {
+    payment: PaymentRequiredResponse['payment'];
+    x402?: PaymentRequiredResponse['x402'];
+    constructor(data: PaymentRequiredResponse);
+}
+
+declare class PowerSun {
+    private baseUrl;
+    private apiKey?;
+    private timeout;
+    readonly market: MarketAPI;
+    readonly buyer: BuyerAPI;
+    constructor(config?: PowerSunConfig);
+    /** Internal HTTP request handler */
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    /** Start registration — returns a challenge to sign with your TRON wallet */
+    register(address: string): Promise<RegisterResponse>;
+    /** Verify signature and receive API key */
+    verify(challengeId: string, address: string, signature: string): Promise<VerifyResponse>;
+    /** Check HTTP 402 payment status (no auth required) */
+    paymentStatus(intentId: string): Promise<PaymentStatusResponse>;
+}
+declare class MarketAPI {
+    private client;
+    constructor(client: PowerSun);
+    /** Get current Energy & Bandwidth prices for all duration tiers */
+    getPrices(): Promise<PricesResponse>;
+    /** Estimate cost for a specific energy amount and duration */
+    estimateCost(params: EstimateCostParams): Promise<EstimateResponse>;
+    /** Check available Energy & Bandwidth in the marketplace */
+    getAvailableResources(): Promise<AvailableResourcesResponse>;
+    /** Full market snapshot — prices, availability, order stats */
+    getOverview(): Promise<MarketOverviewResponse>;
+}
+declare class BuyerAPI {
+    private client;
+    constructor(client: PowerSun);
+    /**
+     * Purchase Energy delegation for a TRON address.
+     *
+     * If authenticated (API key), deducts from balance and returns order.
+     * If not authenticated, throws PaymentRequiredError with payment instructions.
+     *
+     * @throws {PaymentRequiredError} When no API key — contains deposit address and x402 info
+     */
+    buyEnergy(params: BuyEnergyParams): Promise<OrderResponse>;
+    /** Get account balance and deposit info. Requires API key. */
+    getBalance(): Promise<BalanceResponse>;
+    /** Get order status with delegation progress. Requires API key. */
+    getOrderStatus(orderId: string): Promise<OrderStatusResponse>;
+    /**
+     * Broadcast a pre-signed TRON transaction with automatic Energy delegation.
+     * The platform estimates required energy, delegates it, then broadcasts. Requires API key.
+     */
+    broadcast(params: BroadcastParams): Promise<BroadcastResponse>;
+    /** Check HTTP 402 payment status (no auth required) */
+    paymentStatus(intentId: string): Promise<PaymentStatusResponse>;
+}
+
+export { type AvailableResourcesResponse, type BalanceResponse, type BroadcastParams, type BroadcastResponse, type BuyEnergyParams, type EstimateCostParams, type EstimateResponse, type MarketOverviewResponse, type OrderResponse, type OrderStatusResponse, PaymentRequiredError, type PaymentStatusResponse, PowerSun, type PowerSunConfig, PowerSunError, type PriceTier, type PricesResponse, type RegisterResponse, type VerifyResponse };

package/dist/index.d.ts

@@ -0,0 +1,265 @@
+/** PowerSun SDK configuration */
+interface PowerSunConfig {
+    /** API key (format: ps_*). Required for authenticated endpoints. */
+    apiKey?: string;
+    /** Base URL of the PowerSun API. Default: https://powersun.vip */
+    baseUrl?: string;
+    /** Request timeout in ms. Default: 30000 */
+    timeout?: number;
+}
+interface PriceTier {
+    durationMinutes: number;
+    durationLabel: string;
+    energyPriceSun: number;
+    bandwidthPriceSun: number;
+}
+interface PricesResponse {
+    tiers: PriceTier[];
+    updatedAt: string;
+}
+interface EstimateCostParams {
+    energy?: number;
+    bandwidth?: number;
+    txCount?: number;
+    txType?: 'trc20_transfer' | 'trc20_transfer_new' | 'trc10_transfer' | 'contract_call';
+    durationMinutes?: 5 | 10 | 15 | 30 | 60 | 120 | 1440 | 10080;
+    resourceType?: 'ENERGY' | 'BANDWIDTH';
+}
+interface EstimateResponse {
+    estimate: {
+        txCount: number;
+        energyPerTx: number;
+        totalEnergyNeeded: number;
+        durationMinutes: number;
+        resourceType: string;
+    };
+    pricing: {
+        pricePerUnitSun: number;
+        totalCostSun: number;
+        totalCostTrx: number;
+        costPerTxTrx: number;
+        burnCostPerTxTrx: number;
+        savingsPercent: number;
+    };
+    constraints: {
+        minimumOrderSize: number;
+        allowedDurations: number[];
+        meetsMinimum: boolean;
+    };
+    balance?: {
+        currentTrx: number;
+        sufficient: boolean;
+        remainingAfterTrx: number;
+    };
+}
+interface AvailableResourcesResponse {
+    energy: {
+        total: number;
+        available: number;
+    };
+    bandwidth: {
+        total: number;
+        available: number;
+    };
+}
+interface MarketOverviewResponse {
+    prices: PriceTier[];
+    availability: AvailableResourcesResponse;
+    stats: {
+        totalOrders24h: number;
+        totalVolume24hTrx: number;
+        activePools: number;
+    };
+}
+interface BuyEnergyParams {
+    targetAddress: string;
+    txCount: number;
+    txType?: 'trc20_transfer' | 'trc20_transfer_new' | 'trc10_transfer' | 'contract_call';
+    durationMinutes?: 5 | 10 | 15 | 30 | 60 | 120 | 1440 | 10080;
+    resourceType?: 'ENERGY' | 'BANDWIDTH';
+    maxPriceTrx?: number;
+}
+interface OrderResponse {
+    order: {
+        orderId: string;
+        status: 'pending' | 'active' | 'completed' | 'failed';
+        targetAddress: string;
+        resourceType: string;
+        energyAmount: number;
+        durationMinutes: number;
+        totalCostTrx: number;
+        totalCostSun: number;
+        createdAt: string;
+        estimatedDelivery: string;
+    };
+    balance: {
+        previousTrx: number;
+        deductedTrx: number;
+        remainingTrx: number;
+    };
+    nextAction: {
+        action: string;
+        url: string;
+        pollIntervalSeconds: number;
+    };
+}
+interface PaymentRequiredResponse {
+    error: 'payment_required';
+    message: string;
+    payment: {
+        depositAddress: string;
+        requiredAmountTrx: number;
+        requiredAmountSun: number;
+        intentId: string;
+        expiresAt: string;
+        checkStatusUrl: string;
+        scheme: string;
+    };
+    x402?: {
+        scheme: string;
+        network: string;
+        asset: string;
+        maxAmountRequired: string;
+        payTo: string;
+        intentId: string;
+        expiresAt: string;
+    };
+}
+interface BalanceResponse {
+    address: string;
+    balanceTrx: number;
+    balanceSun: number;
+    estimatedCapacity: {
+        trc20Transfers: {
+            count: number;
+            atDuration: string;
+            pricePerTxTrx: number;
+        };
+    };
+    depositAddress: string;
+    depositInstructions: string;
+}
+interface OrderStatusResponse {
+    orderId: string;
+    status: 'pending' | 'active' | 'completed' | 'failed';
+    resourceType: string;
+    energyDelegated: number;
+    targetAddress: string;
+    durationMinutes: number;
+    totalCostTrx: number;
+    createdAt: string;
+    completedAt: string | null;
+    progress: {
+        totalSize: number;
+        filledSize: number;
+        percentFilled: number;
+        fillCount: number;
+    };
+    fills: Array<{
+        poolId: string;
+        filledSize: number;
+        status: string;
+        txHash: string;
+    }>;
+}
+interface PaymentStatusResponse {
+    status: 'pending' | 'success' | 'expired' | 'failed';
+    intentId: string;
+    confirmedAt: string | null;
+    order: {
+        orderId: string;
+        status: string;
+        targetAddress: string;
+    } | null;
+}
+interface BroadcastParams {
+    txData: {
+        txID: string;
+        raw_data: Record<string, unknown>;
+        raw_data_hex?: string;
+        signature?: string[];
+    };
+}
+interface BroadcastResponse {
+    orderId: string;
+    status: string;
+    txId: string;
+    resourceType: string;
+    energyDelegated: number;
+    costTrx: number;
+}
+interface RegisterResponse {
+    challenge: string;
+    challengeId: string;
+    expiresAt: string;
+}
+interface VerifyResponse {
+    apiKey: string;
+    address: string;
+}
+declare class PowerSunError extends Error {
+    status: number;
+    code?: string | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, status: number, code?: string | undefined, details?: unknown | undefined);
+}
+declare class PaymentRequiredError extends PowerSunError {
+    payment: PaymentRequiredResponse['payment'];
+    x402?: PaymentRequiredResponse['x402'];
+    constructor(data: PaymentRequiredResponse);
+}
+
+declare class PowerSun {
+    private baseUrl;
+    private apiKey?;
+    private timeout;
+    readonly market: MarketAPI;
+    readonly buyer: BuyerAPI;
+    constructor(config?: PowerSunConfig);
+    /** Internal HTTP request handler */
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    /** Start registration — returns a challenge to sign with your TRON wallet */
+    register(address: string): Promise<RegisterResponse>;
+    /** Verify signature and receive API key */
+    verify(challengeId: string, address: string, signature: string): Promise<VerifyResponse>;
+    /** Check HTTP 402 payment status (no auth required) */
+    paymentStatus(intentId: string): Promise<PaymentStatusResponse>;
+}
+declare class MarketAPI {
+    private client;
+    constructor(client: PowerSun);
+    /** Get current Energy & Bandwidth prices for all duration tiers */
+    getPrices(): Promise<PricesResponse>;
+    /** Estimate cost for a specific energy amount and duration */
+    estimateCost(params: EstimateCostParams): Promise<EstimateResponse>;
+    /** Check available Energy & Bandwidth in the marketplace */
+    getAvailableResources(): Promise<AvailableResourcesResponse>;
+    /** Full market snapshot — prices, availability, order stats */
+    getOverview(): Promise<MarketOverviewResponse>;
+}
+declare class BuyerAPI {
+    private client;
+    constructor(client: PowerSun);
+    /**
+     * Purchase Energy delegation for a TRON address.
+     *
+     * If authenticated (API key), deducts from balance and returns order.
+     * If not authenticated, throws PaymentRequiredError with payment instructions.
+     *
+     * @throws {PaymentRequiredError} When no API key — contains deposit address and x402 info
+     */
+    buyEnergy(params: BuyEnergyParams): Promise<OrderResponse>;
+    /** Get account balance and deposit info. Requires API key. */
+    getBalance(): Promise<BalanceResponse>;
+    /** Get order status with delegation progress. Requires API key. */
+    getOrderStatus(orderId: string): Promise<OrderStatusResponse>;
+    /**
+     * Broadcast a pre-signed TRON transaction with automatic Energy delegation.
+     * The platform estimates required energy, delegates it, then broadcasts. Requires API key.
+     */
+    broadcast(params: BroadcastParams): Promise<BroadcastResponse>;
+    /** Check HTTP 402 payment status (no auth required) */
+    paymentStatus(intentId: string): Promise<PaymentStatusResponse>;
+}
+
+export { type AvailableResourcesResponse, type BalanceResponse, type BroadcastParams, type BroadcastResponse, type BuyEnergyParams, type EstimateCostParams, type EstimateResponse, type MarketOverviewResponse, type OrderResponse, type OrderStatusResponse, PaymentRequiredError, type PaymentStatusResponse, PowerSun, type PowerSunConfig, PowerSunError, type PriceTier, type PricesResponse, type RegisterResponse, type VerifyResponse };

package/dist/index.js

@@ -0,0 +1,170 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PaymentRequiredError: () => PaymentRequiredError,
+  PowerSun: () => PowerSun,
+  PowerSunError: () => PowerSunError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+var PowerSunError = class extends Error {
+  constructor(message, status, code, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.name = "PowerSunError";
+  }
+};
+var PaymentRequiredError = class extends PowerSunError {
+  constructor(data) {
+    super(data.message, 402, "payment_required");
+    this.name = "PaymentRequiredError";
+    this.payment = data.payment;
+    this.x402 = data.x402;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://powersun.vip";
+var DEFAULT_TIMEOUT = 3e4;
+var PowerSun = class {
+  constructor(config = {}) {
+    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout || DEFAULT_TIMEOUT;
+    this.market = new MarketAPI(this);
+    this.buyer = new BuyerAPI(this);
+  }
+  /** Internal HTTP request handler */
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "User-Agent": "@powersun/mcp-client/1.0.0"
+    };
+    if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      const data = await res.json().catch(() => null);
+      if (res.status === 402 && data) {
+        throw new PaymentRequiredError(data);
+      }
+      if (!res.ok) {
+        throw new PowerSunError(
+          data?.error || data?.message || `HTTP ${res.status}`,
+          res.status,
+          data?.code,
+          data
+        );
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  // ─── Registration (static-like, no API key needed) ────────────────────
+  /** Start registration — returns a challenge to sign with your TRON wallet */
+  async register(address) {
+    return this.request("POST", "/api/v2/agent/register", { address });
+  }
+  /** Verify signature and receive API key */
+  async verify(challengeId, address, signature) {
+    return this.request("POST", "/api/v2/agent/verify", { challengeId, address, signature });
+  }
+  /** Check HTTP 402 payment status (no auth required) */
+  async paymentStatus(intentId) {
+    return this.request("GET", `/api/v2/agent/payment-status/${intentId}`);
+  }
+};
+var MarketAPI = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get current Energy & Bandwidth prices for all duration tiers */
+  async getPrices() {
+    return this.client.request("GET", "/api/v2/agent/prices");
+  }
+  /** Estimate cost for a specific energy amount and duration */
+  async estimateCost(params) {
+    return this.client.request("POST", "/api/v2/agent/estimate", params);
+  }
+  /** Check available Energy & Bandwidth in the marketplace */
+  async getAvailableResources() {
+    return this.client.request("GET", "/api/v2/agent/resources");
+  }
+  /** Full market snapshot — prices, availability, order stats */
+  async getOverview() {
+    return this.client.request("GET", "/api/v2/agent/market-overview");
+  }
+};
+var BuyerAPI = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Purchase Energy delegation for a TRON address.
+   *
+   * If authenticated (API key), deducts from balance and returns order.
+   * If not authenticated, throws PaymentRequiredError with payment instructions.
+   *
+   * @throws {PaymentRequiredError} When no API key — contains deposit address and x402 info
+   */
+  async buyEnergy(params) {
+    return this.client.request("POST", "/api/v2/agent/buy-energy", params);
+  }
+  /** Get account balance and deposit info. Requires API key. */
+  async getBalance() {
+    return this.client.request("GET", "/api/v2/agent/balance");
+  }
+  /** Get order status with delegation progress. Requires API key. */
+  async getOrderStatus(orderId) {
+    return this.client.request("GET", `/api/v2/agent/order/${orderId}`);
+  }
+  /**
+   * Broadcast a pre-signed TRON transaction with automatic Energy delegation.
+   * The platform estimates required energy, delegates it, then broadcasts. Requires API key.
+   */
+  async broadcast(params) {
+    return this.client.request("POST", "/api/v2/agent/broadcast", params);
+  }
+  /** Check HTTP 402 payment status (no auth required) */
+  async paymentStatus(intentId) {
+    return this.client.request("GET", `/api/v2/agent/payment-status/${intentId}`);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PaymentRequiredError,
+  PowerSun,
+  PowerSunError
+});

package/dist/index.mjs

@@ -0,0 +1,141 @@
+// src/types.ts
+var PowerSunError = class extends Error {
+  constructor(message, status, code, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.name = "PowerSunError";
+  }
+};
+var PaymentRequiredError = class extends PowerSunError {
+  constructor(data) {
+    super(data.message, 402, "payment_required");
+    this.name = "PaymentRequiredError";
+    this.payment = data.payment;
+    this.x402 = data.x402;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://powersun.vip";
+var DEFAULT_TIMEOUT = 3e4;
+var PowerSun = class {
+  constructor(config = {}) {
+    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout || DEFAULT_TIMEOUT;
+    this.market = new MarketAPI(this);
+    this.buyer = new BuyerAPI(this);
+  }
+  /** Internal HTTP request handler */
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "User-Agent": "@powersun/mcp-client/1.0.0"
+    };
+    if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      const data = await res.json().catch(() => null);
+      if (res.status === 402 && data) {
+        throw new PaymentRequiredError(data);
+      }
+      if (!res.ok) {
+        throw new PowerSunError(
+          data?.error || data?.message || `HTTP ${res.status}`,
+          res.status,
+          data?.code,
+          data
+        );
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  // ─── Registration (static-like, no API key needed) ────────────────────
+  /** Start registration — returns a challenge to sign with your TRON wallet */
+  async register(address) {
+    return this.request("POST", "/api/v2/agent/register", { address });
+  }
+  /** Verify signature and receive API key */
+  async verify(challengeId, address, signature) {
+    return this.request("POST", "/api/v2/agent/verify", { challengeId, address, signature });
+  }
+  /** Check HTTP 402 payment status (no auth required) */
+  async paymentStatus(intentId) {
+    return this.request("GET", `/api/v2/agent/payment-status/${intentId}`);
+  }
+};
+var MarketAPI = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get current Energy & Bandwidth prices for all duration tiers */
+  async getPrices() {
+    return this.client.request("GET", "/api/v2/agent/prices");
+  }
+  /** Estimate cost for a specific energy amount and duration */
+  async estimateCost(params) {
+    return this.client.request("POST", "/api/v2/agent/estimate", params);
+  }
+  /** Check available Energy & Bandwidth in the marketplace */
+  async getAvailableResources() {
+    return this.client.request("GET", "/api/v2/agent/resources");
+  }
+  /** Full market snapshot — prices, availability, order stats */
+  async getOverview() {
+    return this.client.request("GET", "/api/v2/agent/market-overview");
+  }
+};
+var BuyerAPI = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Purchase Energy delegation for a TRON address.
+   *
+   * If authenticated (API key), deducts from balance and returns order.
+   * If not authenticated, throws PaymentRequiredError with payment instructions.
+   *
+   * @throws {PaymentRequiredError} When no API key — contains deposit address and x402 info
+   */
+  async buyEnergy(params) {
+    return this.client.request("POST", "/api/v2/agent/buy-energy", params);
+  }
+  /** Get account balance and deposit info. Requires API key. */
+  async getBalance() {
+    return this.client.request("GET", "/api/v2/agent/balance");
+  }
+  /** Get order status with delegation progress. Requires API key. */
+  async getOrderStatus(orderId) {
+    return this.client.request("GET", `/api/v2/agent/order/${orderId}`);
+  }
+  /**
+   * Broadcast a pre-signed TRON transaction with automatic Energy delegation.
+   * The platform estimates required energy, delegates it, then broadcasts. Requires API key.
+   */
+  async broadcast(params) {
+    return this.client.request("POST", "/api/v2/agent/broadcast", params);
+  }
+  /** Check HTTP 402 payment status (no auth required) */
+  async paymentStatus(intentId) {
+    return this.client.request("GET", `/api/v2/agent/payment-status/${intentId}`);
+  }
+};
+export {
+  PaymentRequiredError,
+  PowerSun,
+  PowerSunError
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@powersun/mcp-client",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for PowerSun.vip — TRON Energy & Bandwidth marketplace. Buy energy, sell resources, earn passive income.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "tron", "tron-energy", "tron-bandwidth", "trx", "usdt",
+    "energy-rental", "bandwidth", "blockchain", "crypto", "defi",
+    "mcp", "ai-agent", "powersun", "http-402", "x402"
+  ],
+  "author": "PowerSun.vip",
+  "license": "MIT",
+  "homepage": "https://powersun.vip",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Hovsteder/powersun-tron-mcp"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  }
+}