@odisea-labs/pan 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,159 @@
+interface Wallet {
+    id: string;
+    address: string;
+    chains: string[];
+    createdAt: string;
+}
+interface CreateWalletParams {
+    userId: string;
+    email?: string;
+    metadata?: Record<string, unknown>;
+}
+interface PanConfig {
+    apiKey: string;
+    baseURL?: string;
+    debug?: boolean;
+}
+interface PanError$1 {
+    error: string;
+    message: string;
+}
+interface RateLimitError extends PanError$1 {
+    current: number;
+    limit: number;
+}
+type ExecutionStepType = "deposit" | "swap" | "bridge" | "consolidate";
+interface ExecutionStep {
+    type: ExecutionStepType;
+}
+interface DepositStep extends ExecutionStep {
+    type: "deposit";
+    protocol: "aave" | "compound" | "morpho";
+    asset: string;
+    amount: number;
+    chain: string;
+}
+interface SwapStep extends ExecutionStep {
+    type: "swap";
+    from: string;
+    to: string;
+    amount: number;
+    chain: string;
+    maxSlippage?: number;
+    dex?: "1inch" | "uniswap" | "best";
+}
+interface BridgeStep extends ExecutionStep {
+    type: "bridge";
+    fromChain: string;
+    toChain: string;
+    asset: string;
+    amount: number;
+    bridge?: "across" | "stargate" | "best";
+}
+interface ConsolidateStep extends ExecutionStep {
+    type: "consolidate";
+    assets: string[];
+    target: string;
+    chain: string;
+}
+type AnyExecutionStep = DepositStep | SwapStep | BridgeStep | ConsolidateStep;
+interface ExecutionPlan {
+    steps: AnyExecutionStep[];
+    estimatedGas?: number;
+    estimatedTime?: number;
+    strategy: "simple" | "swap" | "multi-asset" | "consolidate";
+    reasoning: string;
+}
+interface ExecutionResult {
+    status: "completed" | "failed";
+    txHash?: string;
+    gasUsed?: number;
+    outputData?: Record<string, unknown>;
+    error?: string;
+}
+interface Intent {
+    id: string;
+    developerId: string;
+    walletId: string;
+    action: string;
+    status: "pending" | "planning" | "executing" | "completed" | "failed";
+    amount: number;
+    executionPlan?: ExecutionPlan;
+    results?: ExecutionResult[];
+    totalGasUsed?: number;
+    totalGasCostUsd?: number;
+    errorMessage?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+interface CreateIntentParams {
+    walletId: string;
+    action: "lend" | "swap" | "bridge";
+    amount: number;
+}
+interface CreateIntentResponse {
+    id: string;
+    status: string;
+    executionPlan: ExecutionPlan;
+    estimatedGas?: number;
+}
+interface LendIntentParams {
+    walletId: string;
+    amount: number;
+}
+interface TokenBalance {
+    asset: string;
+    balance: string;
+    balanceFormatted: string;
+    decimals: number;
+    valueUsd?: number;
+}
+interface ChainBalance {
+    chain: string;
+    tokens: TokenBalance[];
+}
+interface WalletBalances {
+    walletId: string;
+    address: string;
+    chains: ChainBalance[];
+    totalValueUsd?: number;
+}
+
+declare class PanClient {
+    private apiKey;
+    private baseURL;
+    private debug;
+    constructor(config: PanConfig);
+    request<T>(endpoint: string, options?: RequestInit): Promise<T>;
+}
+declare class PanError extends Error {
+    code: string;
+    statusCode: number;
+    details?: unknown;
+    constructor(errorData: any, statusCode?: number);
+}
+
+declare class IntentManager {
+    private client;
+    constructor(client: PanClient);
+    lend(params: LendIntentParams): Promise<CreateIntentResponse>;
+    getIntent(intentId: string): Promise<Intent>;
+}
+
+declare class WalletManager {
+    private client;
+    constructor(client: PanClient);
+    create(params: CreateWalletParams): Promise<Wallet>;
+    get(userId: string): Promise<Wallet>;
+    getBalances(walletId: string): Promise<WalletBalances>;
+}
+
+declare class Pan {
+    private client;
+    wallet: WalletManager;
+    intent: IntentManager;
+    constructor(config: PanConfig);
+}
+
+export { type AnyExecutionStep, type BridgeStep, type ChainBalance, type ConsolidateStep, type CreateIntentParams, type CreateIntentResponse, type CreateWalletParams, type DepositStep, type ExecutionPlan, type ExecutionResult, type ExecutionStep, type ExecutionStepType, type Intent, IntentManager, type LendIntentParams, Pan, PanClient, type PanConfig, PanError, type RateLimitError, type SwapStep, type TokenBalance, type Wallet, type WalletBalances, WalletManager };

package/dist/index.d.ts

@@ -0,0 +1,159 @@
+interface Wallet {
+    id: string;
+    address: string;
+    chains: string[];
+    createdAt: string;
+}
+interface CreateWalletParams {
+    userId: string;
+    email?: string;
+    metadata?: Record<string, unknown>;
+}
+interface PanConfig {
+    apiKey: string;
+    baseURL?: string;
+    debug?: boolean;
+}
+interface PanError$1 {
+    error: string;
+    message: string;
+}
+interface RateLimitError extends PanError$1 {
+    current: number;
+    limit: number;
+}
+type ExecutionStepType = "deposit" | "swap" | "bridge" | "consolidate";
+interface ExecutionStep {
+    type: ExecutionStepType;
+}
+interface DepositStep extends ExecutionStep {
+    type: "deposit";
+    protocol: "aave" | "compound" | "morpho";
+    asset: string;
+    amount: number;
+    chain: string;
+}
+interface SwapStep extends ExecutionStep {
+    type: "swap";
+    from: string;
+    to: string;
+    amount: number;
+    chain: string;
+    maxSlippage?: number;
+    dex?: "1inch" | "uniswap" | "best";
+}
+interface BridgeStep extends ExecutionStep {
+    type: "bridge";
+    fromChain: string;
+    toChain: string;
+    asset: string;
+    amount: number;
+    bridge?: "across" | "stargate" | "best";
+}
+interface ConsolidateStep extends ExecutionStep {
+    type: "consolidate";
+    assets: string[];
+    target: string;
+    chain: string;
+}
+type AnyExecutionStep = DepositStep | SwapStep | BridgeStep | ConsolidateStep;
+interface ExecutionPlan {
+    steps: AnyExecutionStep[];
+    estimatedGas?: number;
+    estimatedTime?: number;
+    strategy: "simple" | "swap" | "multi-asset" | "consolidate";
+    reasoning: string;
+}
+interface ExecutionResult {
+    status: "completed" | "failed";
+    txHash?: string;
+    gasUsed?: number;
+    outputData?: Record<string, unknown>;
+    error?: string;
+}
+interface Intent {
+    id: string;
+    developerId: string;
+    walletId: string;
+    action: string;
+    status: "pending" | "planning" | "executing" | "completed" | "failed";
+    amount: number;
+    executionPlan?: ExecutionPlan;
+    results?: ExecutionResult[];
+    totalGasUsed?: number;
+    totalGasCostUsd?: number;
+    errorMessage?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+interface CreateIntentParams {
+    walletId: string;
+    action: "lend" | "swap" | "bridge";
+    amount: number;
+}
+interface CreateIntentResponse {
+    id: string;
+    status: string;
+    executionPlan: ExecutionPlan;
+    estimatedGas?: number;
+}
+interface LendIntentParams {
+    walletId: string;
+    amount: number;
+}
+interface TokenBalance {
+    asset: string;
+    balance: string;
+    balanceFormatted: string;
+    decimals: number;
+    valueUsd?: number;
+}
+interface ChainBalance {
+    chain: string;
+    tokens: TokenBalance[];
+}
+interface WalletBalances {
+    walletId: string;
+    address: string;
+    chains: ChainBalance[];
+    totalValueUsd?: number;
+}
+
+declare class PanClient {
+    private apiKey;
+    private baseURL;
+    private debug;
+    constructor(config: PanConfig);
+    request<T>(endpoint: string, options?: RequestInit): Promise<T>;
+}
+declare class PanError extends Error {
+    code: string;
+    statusCode: number;
+    details?: unknown;
+    constructor(errorData: any, statusCode?: number);
+}
+
+declare class IntentManager {
+    private client;
+    constructor(client: PanClient);
+    lend(params: LendIntentParams): Promise<CreateIntentResponse>;
+    getIntent(intentId: string): Promise<Intent>;
+}
+
+declare class WalletManager {
+    private client;
+    constructor(client: PanClient);
+    create(params: CreateWalletParams): Promise<Wallet>;
+    get(userId: string): Promise<Wallet>;
+    getBalances(walletId: string): Promise<WalletBalances>;
+}
+
+declare class Pan {
+    private client;
+    wallet: WalletManager;
+    intent: IntentManager;
+    constructor(config: PanConfig);
+}
+
+export { type AnyExecutionStep, type BridgeStep, type ChainBalance, type ConsolidateStep, type CreateIntentParams, type CreateIntentResponse, type CreateWalletParams, type DepositStep, type ExecutionPlan, type ExecutionResult, type ExecutionStep, type ExecutionStepType, type Intent, IntentManager, type LendIntentParams, Pan, PanClient, type PanConfig, PanError, type RateLimitError, type SwapStep, type TokenBalance, type Wallet, type WalletBalances, WalletManager };

package/dist/index.js

@@ -0,0 +1,149 @@
+"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, {
+  IntentManager: () => IntentManager,
+  Pan: () => Pan,
+  PanClient: () => PanClient,
+  PanError: () => PanError,
+  WalletManager: () => WalletManager
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var PanClient = class {
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseURL = config.baseURL || "https://api.pan.com";
+    this.debug = config.debug || false;
+  }
+  async request(endpoint, options = {}) {
+    const url = `${this.baseURL}${endpoint}`;
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      ...options.headers
+    };
+    if (this.debug) {
+      console.log(`[pan SDK] ${options.method || "GET"} ${url}`);
+    }
+    try {
+      const response = await fetch(url, {
+        ...options,
+        headers
+      });
+      const contentType = response.headers.get("content-type");
+      if (!contentType?.includes("application/json")) {
+        const text = await response.text();
+        if (this.debug) {
+          console.log("[pan SDK] Non-JSON response:", text);
+        }
+        throw new Error(
+          `Failed to parse JSON. Response: ${text.substring(0, 200)}`
+        );
+      }
+      const data = await response.json();
+      if (!response.ok) {
+        throw new PanError(data, response.status);
+      }
+      if (this.debug) {
+        console.log("[pan SDK] Response:", data);
+      }
+      return data;
+    } catch (error) {
+      if (error instanceof PanError) throw error;
+      throw new Error(
+        `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+};
+var PanError = class extends Error {
+  constructor(errorData, statusCode) {
+    super(errorData.message || "An error occurred");
+    this.name = "PanError";
+    this.code = errorData.error || "UNKNOWN_ERROR";
+    this.statusCode = statusCode || errorData.statusCode || 500;
+    this.details = errorData;
+  }
+};
+
+// src/intent.ts
+var IntentManager = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async lend(params) {
+    return this.client.request("/api/v1/intents", {
+      method: "POST",
+      body: JSON.stringify({
+        walletId: params.walletId,
+        action: "lend",
+        amount: params.amount
+      })
+    });
+  }
+  async getIntent(intentId) {
+    return this.client.request(`/api/v1/intents/${intentId}`, {
+      method: "GET"
+    });
+  }
+};
+
+// src/wallet.ts
+var WalletManager = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.request("/api/v1/wallets", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  async get(userId) {
+    return this.client.request(`/api/v1/wallets/${userId}`, {
+      method: "GET"
+    });
+  }
+  async getBalances(walletId) {
+    return this.client.request(`/api/v1/balances/${walletId}`, {
+      method: "GET"
+    });
+  }
+};
+
+// src/index.ts
+var Pan = class {
+  constructor(config) {
+    this.client = new PanClient(config);
+    this.wallet = new WalletManager(this.client);
+    this.intent = new IntentManager(this.client);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IntentManager,
+  Pan,
+  PanClient,
+  PanError,
+  WalletManager
+});

package/dist/index.mjs

@@ -0,0 +1,118 @@
+// src/client.ts
+var PanClient = class {
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseURL = config.baseURL || "https://api.pan.com";
+    this.debug = config.debug || false;
+  }
+  async request(endpoint, options = {}) {
+    const url = `${this.baseURL}${endpoint}`;
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      ...options.headers
+    };
+    if (this.debug) {
+      console.log(`[pan SDK] ${options.method || "GET"} ${url}`);
+    }
+    try {
+      const response = await fetch(url, {
+        ...options,
+        headers
+      });
+      const contentType = response.headers.get("content-type");
+      if (!contentType?.includes("application/json")) {
+        const text = await response.text();
+        if (this.debug) {
+          console.log("[pan SDK] Non-JSON response:", text);
+        }
+        throw new Error(
+          `Failed to parse JSON. Response: ${text.substring(0, 200)}`
+        );
+      }
+      const data = await response.json();
+      if (!response.ok) {
+        throw new PanError(data, response.status);
+      }
+      if (this.debug) {
+        console.log("[pan SDK] Response:", data);
+      }
+      return data;
+    } catch (error) {
+      if (error instanceof PanError) throw error;
+      throw new Error(
+        `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+};
+var PanError = class extends Error {
+  constructor(errorData, statusCode) {
+    super(errorData.message || "An error occurred");
+    this.name = "PanError";
+    this.code = errorData.error || "UNKNOWN_ERROR";
+    this.statusCode = statusCode || errorData.statusCode || 500;
+    this.details = errorData;
+  }
+};
+
+// src/intent.ts
+var IntentManager = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async lend(params) {
+    return this.client.request("/api/v1/intents", {
+      method: "POST",
+      body: JSON.stringify({
+        walletId: params.walletId,
+        action: "lend",
+        amount: params.amount
+      })
+    });
+  }
+  async getIntent(intentId) {
+    return this.client.request(`/api/v1/intents/${intentId}`, {
+      method: "GET"
+    });
+  }
+};
+
+// src/wallet.ts
+var WalletManager = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.request("/api/v1/wallets", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  async get(userId) {
+    return this.client.request(`/api/v1/wallets/${userId}`, {
+      method: "GET"
+    });
+  }
+  async getBalances(walletId) {
+    return this.client.request(`/api/v1/balances/${walletId}`, {
+      method: "GET"
+    });
+  }
+};
+
+// src/index.ts
+var Pan = class {
+  constructor(config) {
+    this.client = new PanClient(config);
+    this.wallet = new WalletManager(this.client);
+    this.intent = new IntentManager(this.client);
+  }
+};
+export {
+  IntentManager,
+  Pan,
+  PanClient,
+  PanError,
+  WalletManager
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@odisea-labs/pan",
+  "version": "0.1.0",
+  "description": "Intent-based DeFi API SDK",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch"
+  },
+  "keywords": [
+    "defi",
+    "intent",
+    "web3",
+    "sdk"
+  ],
+  "license": "MIT",
+  "author": "0disea",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/0disea/pan.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/0disea/pan#readme",
+  "bugs": {
+    "url": "https://github.com/0disea/pan/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5"
+  }
+}