stellar-agent-kit 1.0.0

package/dist/index.cjs

@@ -0,0 +1,234 @@
+"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, {
+  MAINNET_ASSETS: () => MAINNET_ASSETS,
+  SOROSWAP_AGGREGATOR: () => SOROSWAP_AGGREGATOR,
+  StellarAgentKit: () => StellarAgentKit,
+  TESTNET_ASSETS: () => TESTNET_ASSETS,
+  createDexClient: () => createDexClient,
+  getNetworkConfig: () => getNetworkConfig,
+  networks: () => networks
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/agent.ts
+var import_stellar_sdk3 = require("@stellar/stellar-sdk");
+
+// src/config/networks.ts
+var import_zod = require("zod");
+var NetworkConfigSchema = import_zod.z.object({
+  horizonUrl: import_zod.z.string().url(),
+  sorobanRpcUrl: import_zod.z.string().url(),
+  friendbotUrl: import_zod.z.string().url().optional()
+});
+var testnet = {
+  horizonUrl: "https://horizon-testnet.stellar.org",
+  sorobanRpcUrl: "https://soroban-testnet.stellar.org",
+  friendbotUrl: "https://friendbot.stellar.org"
+};
+var mainnet = {
+  horizonUrl: "https://horizon.stellar.org",
+  sorobanRpcUrl: "https://soroban-rpc.mainnet.stellar.gateway.fm"
+};
+var networks = { testnet, mainnet };
+function getNetworkConfig(name) {
+  const parsed = import_zod.z.enum(["testnet", "mainnet"]).safeParse(name);
+  if (!parsed.success) throw new Error(`Invalid network: ${name}. Use "testnet" or "mainnet".`);
+  return networks[parsed.data];
+}
+
+// src/dex/soroSwap.ts
+var import_stellar_sdk = require("@stellar/stellar-sdk");
+var import_stellar_sdk2 = require("@stellar/stellar-sdk");
+var SOROSWAP_API_BASE = "https://api.soroswap.finance";
+function assetToApiString(asset) {
+  if (asset.contractId) return asset.contractId;
+  if (asset.code && asset.issuer) return `${asset.code}:${asset.issuer}`;
+  throw new Error("Asset must have contractId or code+issuer");
+}
+function parseApiQuote(data) {
+  const o = data;
+  return {
+    expectedIn: String(o?.expectedIn ?? o?.amountIn ?? "0"),
+    expectedOut: String(o?.expectedOut ?? o?.amountOut ?? "0"),
+    minOut: String(o?.minOut ?? o?.minimumAmountOut ?? o?.expectedOut ?? "0"),
+    route: Array.isArray(o?.route) ? o.route : Array.isArray(o?.path) ? o.path : [],
+    rawData: data
+  };
+}
+function createSoroSwapDexClient(networkConfig, apiKey) {
+  const networkName = networkConfig.horizonUrl.includes("testnet") ? "testnet" : "mainnet";
+  const key = apiKey ?? process.env.SOROSWAP_API_KEY;
+  async function getQuote(from, to, amount) {
+    const url = `${SOROSWAP_API_BASE}/quote?network=${networkName}`;
+    const body = {
+      assetIn: assetToApiString(from),
+      assetOut: assetToApiString(to),
+      amount: String(amount).trim(),
+      tradeType: "EXACT_IN",
+      protocols: ["soroswap", "phoenix", "aqua"]
+    };
+    const headers = { "Content-Type": "application/json" };
+    if (key) headers["Authorization"] = `Bearer ${key}`;
+    const res = await fetch(url, { method: "POST", headers, body: JSON.stringify(body) });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`SoroSwap quote failed ${res.status}: ${text}`);
+    }
+    return parseApiQuote(await res.json());
+  }
+  async function executeSwap(secretKey, quote) {
+    if (!key) throw new Error("executeSwap requires SOROSWAP_API_KEY");
+    const keypair = import_stellar_sdk.Keypair.fromSecret(secretKey.trim());
+    const fromAddress = keypair.publicKey();
+    const buildUrl = `${SOROSWAP_API_BASE}/quote/build?network=${networkName}`;
+    const buildRes = await fetch(buildUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${key}` },
+      body: JSON.stringify({ quote: quote.rawData ?? quote, from: fromAddress, to: fromAddress })
+    });
+    if (!buildRes.ok) throw new Error(`SoroSwap build failed ${buildRes.status}: ${await buildRes.text()}`);
+    const buildData = await buildRes.json();
+    const xdrBase64 = buildData?.xdr;
+    if (!xdrBase64 || typeof xdrBase64 !== "string") throw new Error("SoroSwap build response missing xdr");
+    const config = getNetworkConfig(networkName);
+    const networkPassphrase = config.horizonUrl.includes("testnet") ? import_stellar_sdk.Networks.TESTNET : import_stellar_sdk.Networks.PUBLIC;
+    const tx = import_stellar_sdk.TransactionBuilder.fromXDR(xdrBase64, networkPassphrase);
+    tx.sign(keypair);
+    const server = new import_stellar_sdk2.rpc.Server(config.sorobanRpcUrl, { allowHttp: config.sorobanRpcUrl.startsWith("http:") });
+    const sendResult = await server.sendTransaction(tx);
+    if (sendResult.errorResult) throw new Error(`Soroban sendTransaction failed: ${String(sendResult.errorResult)}`);
+    return { hash: sendResult.hash, status: sendResult.status ?? "PENDING" };
+  }
+  return { getQuote, executeSwap };
+}
+
+// src/dex/index.ts
+function createDexClient(networkConfig, apiKey) {
+  return createSoroSwapDexClient(networkConfig, apiKey);
+}
+
+// src/agent.ts
+var StellarAgentKit = class {
+  keypair;
+  network;
+  config;
+  _initialized = false;
+  _dex = null;
+  _horizon = null;
+  constructor(secretKey, network) {
+    this.keypair = import_stellar_sdk3.Keypair.fromSecret(secretKey.trim());
+    this.network = network;
+    this.config = getNetworkConfig(network);
+  }
+  /**
+   * Initialize clients (Horizon, Soroban RPC, protocol wrappers).
+   * Call after construction before using protocol methods.
+   */
+  async initialize() {
+    this._horizon = new import_stellar_sdk3.Horizon.Server(this.config.horizonUrl);
+    this._dex = createDexClient(this.config, process.env.SOROSWAP_API_KEY);
+    this._initialized = true;
+    return this;
+  }
+  ensureInitialized() {
+    if (!this._initialized || !this._dex) {
+      throw new Error("StellarAgentKit not initialized. Call await agent.initialize() first.");
+    }
+  }
+  // ─── DEX Operations (mirror Mantle agniSwap / executeSwap) ─────────────────
+  /**
+   * Get a swap quote (exact-in). Uses SoroSwap aggregator (SoroSwap, Phoenix, Aqua).
+   */
+  async dexGetQuote(fromAsset, toAsset, amount) {
+    this.ensureInitialized();
+    return this._dex.getQuote(fromAsset, toAsset, amount);
+  }
+  /**
+   * Execute a swap using a prior quote.
+   */
+  async dexSwap(quote) {
+    this.ensureInitialized();
+    return this._dex.executeSwap(this.keypair.secret(), quote);
+  }
+  /**
+   * One-shot: get quote and execute swap (convenience).
+   */
+  async dexSwapExactIn(fromAsset, toAsset, amount) {
+    const quote = await this.dexGetQuote(fromAsset, toAsset, amount);
+    return this.dexSwap(quote);
+  }
+  // ─── Payments (Horizon) ────────────────────────────────────────────────────
+  /**
+   * Send a native or custom-asset payment (Horizon).
+   * @param to - Destination account (G...)
+   * @param amount - Amount in display units (e.g. "10" for 10 XLM)
+   * @param assetCode - Optional; omit for native XLM
+   * @param assetIssuer - Optional; required if assetCode is set
+   */
+  async sendPayment(to, amount, assetCode, assetIssuer) {
+    this.ensureInitialized();
+    if (!this._horizon) throw new Error("Horizon not initialized");
+    const networkPassphrase = this.network === "testnet" ? import_stellar_sdk3.Networks.TESTNET : import_stellar_sdk3.Networks.PUBLIC;
+    const sourceAccount = await this._horizon.loadAccount(this.keypair.publicKey());
+    const asset = assetCode && assetIssuer ? new import_stellar_sdk3.Asset(assetCode, assetIssuer) : import_stellar_sdk3.Asset.native();
+    const tx = new import_stellar_sdk3.TransactionBuilder(sourceAccount, {
+      fee: "100",
+      networkPassphrase
+    }).addOperation(import_stellar_sdk3.Operation.payment({ destination: to, asset, amount })).setTimeout(180).build();
+    tx.sign(this.keypair);
+    const result = await this._horizon.submitTransaction(tx);
+    return { hash: result.hash };
+  }
+  // ─── Placeholders for lending / oracle / cross-chain (plug later) ────────────
+  // async lendingSupply(asset: DexAsset, amount: string): Promise<{ hash: string }> { ... }
+  // async lendingBorrow(asset: DexAsset, amount: string): Promise<{ hash: string }> { ... }
+  // async getPrice(assetOrFeedId: string): Promise<{ price: string }> { ... }
+  // async crossChainSwap(...): Promise<SwapResult> { ... }
+};
+
+// src/config/assets.ts
+var TESTNET_ASSETS = {
+  XLM: { contractId: "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC" },
+  USDC: { contractId: "CBBHRKEP5M3NUDRISGLJKGHDHX3DA2CN2AZBQY6WLVUJ7VNLGSKBDUCM" },
+  /** Classic testnet USDC */
+  AUSDC: { code: "AUSDC", issuer: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN" }
+};
+var MAINNET_ASSETS = {
+  XLM: { contractId: "CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA" },
+  USDC: { contractId: "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75" }
+};
+var SOROSWAP_AGGREGATOR = {
+  testnet: "CCJUD55AG6W5HAI5LRVNKAE5WDP5XGZBUDS5WNTIVDU7O264UZZE7BRD",
+  mainnet: "CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MAINNET_ASSETS,
+  SOROSWAP_AGGREGATOR,
+  StellarAgentKit,
+  TESTNET_ASSETS,
+  createDexClient,
+  getNetworkConfig,
+  networks
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/agent.ts","../src/config/networks.ts","../src/dex/soroSwap.ts","../src/dex/index.ts","../src/config/assets.ts"],"sourcesContent":["export { StellarAgentKit, type StellarNetwork } from \"./agent.js\";\nexport { getNetworkConfig, networks, type NetworkConfig, type NetworkName } from \"./config/networks.js\";\nexport {\n  TESTNET_ASSETS,\n  MAINNET_ASSETS,\n  SOROSWAP_AGGREGATOR,\n  type StellarAsset,\n} from \"./config/assets.js\";\nexport {\n  createDexClient,\n  type DexClient,\n  type DexAsset,\n  type QuoteResult,\n  type SwapResult,\n} from \"./dex/index.js\";\n","/**\n * StellarAgentKit – unified DeFi agent (MNTAgentKit-style API for Stellar).\n * Constructor(secretKey, network) + initialize() then protocol methods.\n */\n\nimport { Keypair, Asset, TransactionBuilder, Operation, Networks, Horizon } from \"@stellar/stellar-sdk\";\nimport { getNetworkConfig, type NetworkConfig } from \"./config/networks.js\";\nimport { createDexClient, type DexAsset, type QuoteResult, type SwapResult } from \"./dex/index.js\";\n\nexport type StellarNetwork = \"mainnet\" | \"testnet\";\n\nexport class StellarAgentKit {\n  public readonly keypair: Keypair;\n  public readonly network: StellarNetwork;\n  public readonly config: NetworkConfig;\n  private _initialized = false;\n  private _dex: ReturnType<typeof createDexClient> | null = null;\n  private _horizon: Horizon.Server | null = null;\n\n  constructor(secretKey: string, network: StellarNetwork) {\n    this.keypair = Keypair.fromSecret(secretKey.trim());\n    this.network = network;\n    this.config = getNetworkConfig(network);\n  }\n\n  /**\n   * Initialize clients (Horizon, Soroban RPC, protocol wrappers).\n   * Call after construction before using protocol methods.\n   */\n  async initialize(): Promise<this> {\n    this._horizon = new Horizon.Server(this.config.horizonUrl);\n    this._dex = createDexClient(this.config, process.env.SOROSWAP_API_KEY);\n    this._initialized = true;\n    return this;\n  }\n\n  private ensureInitialized(): void {\n    if (!this._initialized || !this._dex) {\n      throw new Error(\"StellarAgentKit not initialized. Call await agent.initialize() first.\");\n    }\n  }\n\n  // ─── DEX Operations (mirror Mantle agniSwap / executeSwap) ─────────────────\n\n  /**\n   * Get a swap quote (exact-in). Uses SoroSwap aggregator (SoroSwap, Phoenix, Aqua).\n   */\n  async dexGetQuote(\n    fromAsset: DexAsset,\n    toAsset: DexAsset,\n    amount: string\n  ): Promise<QuoteResult> {\n    this.ensureInitialized();\n    return this._dex!.getQuote(fromAsset, toAsset, amount);\n  }\n\n  /**\n   * Execute a swap using a prior quote.\n   */\n  async dexSwap(quote: QuoteResult): Promise<SwapResult> {\n    this.ensureInitialized();\n    return this._dex!.executeSwap(this.keypair.secret(), quote);\n  }\n\n  /**\n   * One-shot: get quote and execute swap (convenience).\n   */\n  async dexSwapExactIn(\n    fromAsset: DexAsset,\n    toAsset: DexAsset,\n    amount: string\n  ): Promise<SwapResult> {\n    const quote = await this.dexGetQuote(fromAsset, toAsset, amount);\n    return this.dexSwap(quote);\n  }\n\n  // ─── Payments (Horizon) ────────────────────────────────────────────────────\n\n  /**\n   * Send a native or custom-asset payment (Horizon).\n   * @param to - Destination account (G...)\n   * @param amount - Amount in display units (e.g. \"10\" for 10 XLM)\n   * @param assetCode - Optional; omit for native XLM\n   * @param assetIssuer - Optional; required if assetCode is set\n   */\n  async sendPayment(\n    to: string,\n    amount: string,\n    assetCode?: string,\n    assetIssuer?: string\n  ): Promise<{ hash: string }> {\n    this.ensureInitialized();\n    if (!this._horizon) throw new Error(\"Horizon not initialized\");\n\n    const networkPassphrase =\n      this.network === \"testnet\" ? Networks.TESTNET : Networks.PUBLIC;\n    const sourceAccount = await this._horizon.loadAccount(this.keypair.publicKey());\n\n    const asset =\n      assetCode && assetIssuer\n        ? new Asset(assetCode, assetIssuer)\n        : Asset.native();\n\n    const tx = new TransactionBuilder(sourceAccount, {\n      fee: \"100\",\n      networkPassphrase,\n    })\n      .addOperation(Operation.payment({ destination: to, asset, amount }))\n      .setTimeout(180)\n      .build();\n\n    tx.sign(this.keypair);\n    const result = await this._horizon.submitTransaction(tx);\n    return { hash: result.hash };\n  }\n\n  // ─── Placeholders for lending / oracle / cross-chain (plug later) ────────────\n\n  // async lendingSupply(asset: DexAsset, amount: string): Promise<{ hash: string }> { ... }\n  // async lendingBorrow(asset: DexAsset, amount: string): Promise<{ hash: string }> { ... }\n  // async getPrice(assetOrFeedId: string): Promise<{ price: string }> { ... }\n  // async crossChainSwap(...): Promise<SwapResult> { ... }\n}\n","import { z } from \"zod\";\n\nexport const NetworkConfigSchema = z.object({\n  horizonUrl: z.string().url(),\n  sorobanRpcUrl: z.string().url(),\n  friendbotUrl: z.string().url().optional(),\n});\n\nexport type NetworkConfig = z.infer<typeof NetworkConfigSchema>;\n\nexport const testnet: NetworkConfig = {\n  horizonUrl: \"https://horizon-testnet.stellar.org\",\n  sorobanRpcUrl: \"https://soroban-testnet.stellar.org\",\n  friendbotUrl: \"https://friendbot.stellar.org\",\n};\n\nexport const mainnet: NetworkConfig = {\n  horizonUrl: \"https://horizon.stellar.org\",\n  sorobanRpcUrl: \"https://soroban-rpc.mainnet.stellar.gateway.fm\",\n};\n\nexport const networks = { testnet, mainnet } as const;\nexport type NetworkName = keyof typeof networks;\n\nexport function getNetworkConfig(name: string): NetworkConfig {\n  const parsed = z.enum([\"testnet\", \"mainnet\"]).safeParse(name);\n  if (!parsed.success) throw new Error(`Invalid network: ${name}. Use \"testnet\" or \"mainnet\".`);\n  return networks[parsed.data];\n}\n","/**\n * SoroSwap DEX client – quote via API, build + sign + submit for executeSwap.\n */\n\nimport { Keypair, TransactionBuilder, Networks } from \"@stellar/stellar-sdk\";\nimport { rpc } from \"@stellar/stellar-sdk\";\nimport type { NetworkConfig } from \"../config/networks.js\";\nimport { getNetworkConfig, type NetworkName } from \"../config/networks.js\";\nimport type { DexAsset, QuoteResult, SwapResult } from \"./types.js\";\n\nconst SOROSWAP_API_BASE = \"https://api.soroswap.finance\";\n\nfunction assetToApiString(asset: DexAsset): string {\n  if (asset.contractId) return asset.contractId;\n  if (asset.code && asset.issuer) return `${asset.code}:${asset.issuer}`;\n  throw new Error(\"Asset must have contractId or code+issuer\");\n}\n\nfunction parseApiQuote(data: unknown): QuoteResult {\n  const o = data as Record<string, unknown>;\n  return {\n    expectedIn: String(o?.expectedIn ?? o?.amountIn ?? \"0\"),\n    expectedOut: String(o?.expectedOut ?? o?.amountOut ?? \"0\"),\n    minOut: String(o?.minOut ?? o?.minimumAmountOut ?? o?.expectedOut ?? \"0\"),\n    route: Array.isArray(o?.route) ? (o.route as string[]) : Array.isArray(o?.path) ? (o.path as string[]) : [],\n    rawData: data,\n  };\n}\n\nexport function createSoroSwapDexClient(\n  networkConfig: NetworkConfig,\n  apiKey?: string\n): { getQuote: (from: DexAsset, to: DexAsset, amount: string) => Promise<QuoteResult>; executeSwap: (secretKey: string, quote: QuoteResult) => Promise<SwapResult> } {\n  const networkName: NetworkName = networkConfig.horizonUrl.includes(\"testnet\") ? \"testnet\" : \"mainnet\";\n  const key = apiKey ?? process.env.SOROSWAP_API_KEY;\n\n  async function getQuote(from: DexAsset, to: DexAsset, amount: string): Promise<QuoteResult> {\n    const url = `${SOROSWAP_API_BASE}/quote?network=${networkName}`;\n    const body = {\n      assetIn: assetToApiString(from),\n      assetOut: assetToApiString(to),\n      amount: String(amount).trim(),\n      tradeType: \"EXACT_IN\",\n      protocols: [\"soroswap\", \"phoenix\", \"aqua\"],\n    };\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (key) headers[\"Authorization\"] = `Bearer ${key}`;\n    const res = await fetch(url, { method: \"POST\", headers, body: JSON.stringify(body) });\n    if (!res.ok) {\n      const text = await res.text();\n      throw new Error(`SoroSwap quote failed ${res.status}: ${text}`);\n    }\n    return parseApiQuote(await res.json());\n  }\n\n  async function executeSwap(secretKey: string, quote: QuoteResult): Promise<SwapResult> {\n    if (!key) throw new Error(\"executeSwap requires SOROSWAP_API_KEY\");\n    const keypair = Keypair.fromSecret(secretKey.trim());\n    const fromAddress = keypair.publicKey();\n    const buildUrl = `${SOROSWAP_API_BASE}/quote/build?network=${networkName}`;\n    const buildRes = await fetch(buildUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\", Authorization: `Bearer ${key}` },\n      body: JSON.stringify({ quote: quote.rawData ?? quote, from: fromAddress, to: fromAddress }),\n    });\n    if (!buildRes.ok) throw new Error(`SoroSwap build failed ${buildRes.status}: ${await buildRes.text()}`);\n    const buildData = (await buildRes.json()) as { xdr?: string };\n    const xdrBase64 = buildData?.xdr;\n    if (!xdrBase64 || typeof xdrBase64 !== \"string\") throw new Error(\"SoroSwap build response missing xdr\");\n    const config = getNetworkConfig(networkName);\n    const networkPassphrase = config.horizonUrl.includes(\"testnet\") ? Networks.TESTNET : Networks.PUBLIC;\n    const tx = TransactionBuilder.fromXDR(xdrBase64, networkPassphrase);\n    tx.sign(keypair);\n    const server = new rpc.Server(config.sorobanRpcUrl, { allowHttp: config.sorobanRpcUrl.startsWith(\"http:\") });\n    const sendResult = await server.sendTransaction(tx);\n    if (sendResult.errorResult) throw new Error(`Soroban sendTransaction failed: ${String(sendResult.errorResult)}`);\n    return { hash: sendResult.hash, status: sendResult.status ?? \"PENDING\" };\n  }\n\n  return { getQuote, executeSwap };\n}\n","/**\n * DEX module – swap, quote, aggregator (SoroSwap).\n * Pluggable: add more DEXes by implementing DexClient.\n */\n\nimport type { NetworkConfig } from \"../config/networks.js\";\nimport type { DexAsset, QuoteResult, SwapResult } from \"./types.js\";\nimport { createSoroSwapDexClient } from \"./soroSwap.js\";\n\nexport type { DexAsset, QuoteResult, SwapResult } from \"./types.js\";\nexport { createSoroSwapDexClient } from \"./soroSwap.js\";\n\nexport interface DexClient {\n  getQuote(fromAsset: DexAsset, toAsset: DexAsset, amount: string): Promise<QuoteResult>;\n  executeSwap(secretKey: string, quote: QuoteResult): Promise<SwapResult>;\n}\n\n/**\n * Build a DEX client for the given network (SoroSwap aggregator).\n */\nexport function createDexClient(networkConfig: NetworkConfig, apiKey?: string): DexClient {\n  return createSoroSwapDexClient(networkConfig, apiKey);\n}\n","/**\n * Stellar asset identifiers and contract addresses.\n * Centralized for mainnet/testnet (mirrors Mantle DevKit \"Token Addresses\").\n */\n\nexport type StellarAsset = { code: string; issuer: string } | { contractId: string };\n\nexport const TESTNET_ASSETS = {\n  XLM: { contractId: \"CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC\" },\n  USDC: { contractId: \"CBBHRKEP5M3NUDRISGLJKGHDHX3DA2CN2AZBQY6WLVUJ7VNLGSKBDUCM\" },\n  /** Classic testnet USDC */\n  AUSDC: { code: \"AUSDC\", issuer: \"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN\" },\n} as const;\n\nexport const MAINNET_ASSETS = {\n  XLM: { contractId: \"CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA\" },\n  USDC: { contractId: \"CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75\" },\n} as const;\n\nexport const SOROSWAP_AGGREGATOR = {\n  testnet: \"CCJUD55AG6W5HAI5LRVNKAE5WDP5XGZBUDS5WNTIVDU7O264UZZE7BRD\",\n  mainnet: \"CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH\",\n} as const;\n"],"mappings":"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","names":["import_stellar_sdk","import_stellar_sdk"]}

package/dist/index.d.cts

@@ -0,0 +1,147 @@
+import { Keypair } from '@stellar/stellar-sdk';
+import { z } from 'zod';
+
+declare const NetworkConfigSchema: z.ZodObject<{
+    horizonUrl: z.ZodString;
+    sorobanRpcUrl: z.ZodString;
+    friendbotUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    horizonUrl: string;
+    sorobanRpcUrl: string;
+    friendbotUrl?: string | undefined;
+}, {
+    horizonUrl: string;
+    sorobanRpcUrl: string;
+    friendbotUrl?: string | undefined;
+}>;
+type NetworkConfig = z.infer<typeof NetworkConfigSchema>;
+declare const networks: {
+    readonly testnet: {
+        horizonUrl: string;
+        sorobanRpcUrl: string;
+        friendbotUrl?: string | undefined;
+    };
+    readonly mainnet: {
+        horizonUrl: string;
+        sorobanRpcUrl: string;
+        friendbotUrl?: string | undefined;
+    };
+};
+type NetworkName = keyof typeof networks;
+declare function getNetworkConfig(name: string): NetworkConfig;
+
+/**
+ * DEX / swap types (Stellar: asset = code+issuer or contractId).
+ */
+interface DexAsset {
+    contractId?: string;
+    code?: string;
+    issuer?: string;
+}
+interface QuoteResult {
+    expectedIn: string;
+    expectedOut: string;
+    minOut: string;
+    route: string[];
+    rawData?: unknown;
+}
+interface SwapResult {
+    hash: string;
+    status: string;
+}
+
+/**
+ * DEX module – swap, quote, aggregator (SoroSwap).
+ * Pluggable: add more DEXes by implementing DexClient.
+ */
+
+interface DexClient {
+    getQuote(fromAsset: DexAsset, toAsset: DexAsset, amount: string): Promise<QuoteResult>;
+    executeSwap(secretKey: string, quote: QuoteResult): Promise<SwapResult>;
+}
+/**
+ * Build a DEX client for the given network (SoroSwap aggregator).
+ */
+declare function createDexClient(networkConfig: NetworkConfig, apiKey?: string): DexClient;
+
+/**
+ * StellarAgentKit – unified DeFi agent (MNTAgentKit-style API for Stellar).
+ * Constructor(secretKey, network) + initialize() then protocol methods.
+ */
+
+type StellarNetwork = "mainnet" | "testnet";
+declare class StellarAgentKit {
+    readonly keypair: Keypair;
+    readonly network: StellarNetwork;
+    readonly config: NetworkConfig;
+    private _initialized;
+    private _dex;
+    private _horizon;
+    constructor(secretKey: string, network: StellarNetwork);
+    /**
+     * Initialize clients (Horizon, Soroban RPC, protocol wrappers).
+     * Call after construction before using protocol methods.
+     */
+    initialize(): Promise<this>;
+    private ensureInitialized;
+    /**
+     * Get a swap quote (exact-in). Uses SoroSwap aggregator (SoroSwap, Phoenix, Aqua).
+     */
+    dexGetQuote(fromAsset: DexAsset, toAsset: DexAsset, amount: string): Promise<QuoteResult>;
+    /**
+     * Execute a swap using a prior quote.
+     */
+    dexSwap(quote: QuoteResult): Promise<SwapResult>;
+    /**
+     * One-shot: get quote and execute swap (convenience).
+     */
+    dexSwapExactIn(fromAsset: DexAsset, toAsset: DexAsset, amount: string): Promise<SwapResult>;
+    /**
+     * Send a native or custom-asset payment (Horizon).
+     * @param to - Destination account (G...)
+     * @param amount - Amount in display units (e.g. "10" for 10 XLM)
+     * @param assetCode - Optional; omit for native XLM
+     * @param assetIssuer - Optional; required if assetCode is set
+     */
+    sendPayment(to: string, amount: string, assetCode?: string, assetIssuer?: string): Promise<{
+        hash: string;
+    }>;
+}
+
+/**
+ * Stellar asset identifiers and contract addresses.
+ * Centralized for mainnet/testnet (mirrors Mantle DevKit "Token Addresses").
+ */
+type StellarAsset = {
+    code: string;
+    issuer: string;
+} | {
+    contractId: string;
+};
+declare const TESTNET_ASSETS: {
+    readonly XLM: {
+        readonly contractId: "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC";
+    };
+    readonly USDC: {
+        readonly contractId: "CBBHRKEP5M3NUDRISGLJKGHDHX3DA2CN2AZBQY6WLVUJ7VNLGSKBDUCM";
+    };
+    /** Classic testnet USDC */
+    readonly AUSDC: {
+        readonly code: "AUSDC";
+        readonly issuer: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN";
+    };
+};
+declare const MAINNET_ASSETS: {
+    readonly XLM: {
+        readonly contractId: "CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA";
+    };
+    readonly USDC: {
+        readonly contractId: "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75";
+    };
+};
+declare const SOROSWAP_AGGREGATOR: {
+    readonly testnet: "CCJUD55AG6W5HAI5LRVNKAE5WDP5XGZBUDS5WNTIVDU7O264UZZE7BRD";
+    readonly mainnet: "CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH";
+};
+
+export { type DexAsset, type DexClient, MAINNET_ASSETS, type NetworkConfig, type NetworkName, type QuoteResult, SOROSWAP_AGGREGATOR, StellarAgentKit, type StellarAsset, type StellarNetwork, type SwapResult, TESTNET_ASSETS, createDexClient, getNetworkConfig, networks };

package/dist/index.d.ts

@@ -0,0 +1,147 @@
+import { Keypair } from '@stellar/stellar-sdk';
+import { z } from 'zod';
+
+declare const NetworkConfigSchema: z.ZodObject<{
+    horizonUrl: z.ZodString;
+    sorobanRpcUrl: z.ZodString;
+    friendbotUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    horizonUrl: string;
+    sorobanRpcUrl: string;
+    friendbotUrl?: string | undefined;
+}, {
+    horizonUrl: string;
+    sorobanRpcUrl: string;
+    friendbotUrl?: string | undefined;
+}>;
+type NetworkConfig = z.infer<typeof NetworkConfigSchema>;
+declare const networks: {
+    readonly testnet: {
+        horizonUrl: string;
+        sorobanRpcUrl: string;
+        friendbotUrl?: string | undefined;
+    };
+    readonly mainnet: {
+        horizonUrl: string;
+        sorobanRpcUrl: string;
+        friendbotUrl?: string | undefined;
+    };
+};
+type NetworkName = keyof typeof networks;
+declare function getNetworkConfig(name: string): NetworkConfig;
+
+/**
+ * DEX / swap types (Stellar: asset = code+issuer or contractId).
+ */
+interface DexAsset {
+    contractId?: string;
+    code?: string;
+    issuer?: string;
+}
+interface QuoteResult {
+    expectedIn: string;
+    expectedOut: string;
+    minOut: string;
+    route: string[];
+    rawData?: unknown;
+}
+interface SwapResult {
+    hash: string;
+    status: string;
+}
+
+/**
+ * DEX module – swap, quote, aggregator (SoroSwap).
+ * Pluggable: add more DEXes by implementing DexClient.
+ */
+
+interface DexClient {
+    getQuote(fromAsset: DexAsset, toAsset: DexAsset, amount: string): Promise<QuoteResult>;
+    executeSwap(secretKey: string, quote: QuoteResult): Promise<SwapResult>;
+}
+/**
+ * Build a DEX client for the given network (SoroSwap aggregator).
+ */
+declare function createDexClient(networkConfig: NetworkConfig, apiKey?: string): DexClient;
+
+/**
+ * StellarAgentKit – unified DeFi agent (MNTAgentKit-style API for Stellar).
+ * Constructor(secretKey, network) + initialize() then protocol methods.
+ */
+
+type StellarNetwork = "mainnet" | "testnet";
+declare class StellarAgentKit {
+    readonly keypair: Keypair;
+    readonly network: StellarNetwork;
+    readonly config: NetworkConfig;
+    private _initialized;
+    private _dex;
+    private _horizon;
+    constructor(secretKey: string, network: StellarNetwork);
+    /**
+     * Initialize clients (Horizon, Soroban RPC, protocol wrappers).
+     * Call after construction before using protocol methods.
+     */
+    initialize(): Promise<this>;
+    private ensureInitialized;
+    /**
+     * Get a swap quote (exact-in). Uses SoroSwap aggregator (SoroSwap, Phoenix, Aqua).
+     */
+    dexGetQuote(fromAsset: DexAsset, toAsset: DexAsset, amount: string): Promise<QuoteResult>;
+    /**
+     * Execute a swap using a prior quote.
+     */
+    dexSwap(quote: QuoteResult): Promise<SwapResult>;
+    /**
+     * One-shot: get quote and execute swap (convenience).
+     */
+    dexSwapExactIn(fromAsset: DexAsset, toAsset: DexAsset, amount: string): Promise<SwapResult>;
+    /**
+     * Send a native or custom-asset payment (Horizon).
+     * @param to - Destination account (G...)
+     * @param amount - Amount in display units (e.g. "10" for 10 XLM)
+     * @param assetCode - Optional; omit for native XLM
+     * @param assetIssuer - Optional; required if assetCode is set
+     */
+    sendPayment(to: string, amount: string, assetCode?: string, assetIssuer?: string): Promise<{
+        hash: string;
+    }>;
+}
+
+/**
+ * Stellar asset identifiers and contract addresses.
+ * Centralized for mainnet/testnet (mirrors Mantle DevKit "Token Addresses").
+ */
+type StellarAsset = {
+    code: string;
+    issuer: string;
+} | {
+    contractId: string;
+};
+declare const TESTNET_ASSETS: {
+    readonly XLM: {
+        readonly contractId: "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC";
+    };
+    readonly USDC: {
+        readonly contractId: "CBBHRKEP5M3NUDRISGLJKGHDHX3DA2CN2AZBQY6WLVUJ7VNLGSKBDUCM";
+    };
+    /** Classic testnet USDC */
+    readonly AUSDC: {
+        readonly code: "AUSDC";
+        readonly issuer: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN";
+    };
+};
+declare const MAINNET_ASSETS: {
+    readonly XLM: {
+        readonly contractId: "CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA";
+    };
+    readonly USDC: {
+        readonly contractId: "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75";
+    };
+};
+declare const SOROSWAP_AGGREGATOR: {
+    readonly testnet: "CCJUD55AG6W5HAI5LRVNKAE5WDP5XGZBUDS5WNTIVDU7O264UZZE7BRD";
+    readonly mainnet: "CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH";
+};
+
+export { type DexAsset, type DexClient, MAINNET_ASSETS, type NetworkConfig, type NetworkName, type QuoteResult, SOROSWAP_AGGREGATOR, StellarAgentKit, type StellarAsset, type StellarNetwork, type SwapResult, TESTNET_ASSETS, createDexClient, getNetworkConfig, networks };

package/dist/index.js

@@ -0,0 +1,201 @@
+// src/agent.ts
+import { Keypair as Keypair2, Asset, TransactionBuilder as TransactionBuilder2, Operation, Networks as Networks2, Horizon } from "@stellar/stellar-sdk";
+
+// src/config/networks.ts
+import { z } from "zod";
+var NetworkConfigSchema = z.object({
+  horizonUrl: z.string().url(),
+  sorobanRpcUrl: z.string().url(),
+  friendbotUrl: z.string().url().optional()
+});
+var testnet = {
+  horizonUrl: "https://horizon-testnet.stellar.org",
+  sorobanRpcUrl: "https://soroban-testnet.stellar.org",
+  friendbotUrl: "https://friendbot.stellar.org"
+};
+var mainnet = {
+  horizonUrl: "https://horizon.stellar.org",
+  sorobanRpcUrl: "https://soroban-rpc.mainnet.stellar.gateway.fm"
+};
+var networks = { testnet, mainnet };
+function getNetworkConfig(name) {
+  const parsed = z.enum(["testnet", "mainnet"]).safeParse(name);
+  if (!parsed.success) throw new Error(`Invalid network: ${name}. Use "testnet" or "mainnet".`);
+  return networks[parsed.data];
+}
+
+// src/dex/soroSwap.ts
+import { Keypair, TransactionBuilder, Networks } from "@stellar/stellar-sdk";
+import { rpc } from "@stellar/stellar-sdk";
+var SOROSWAP_API_BASE = "https://api.soroswap.finance";
+function assetToApiString(asset) {
+  if (asset.contractId) return asset.contractId;
+  if (asset.code && asset.issuer) return `${asset.code}:${asset.issuer}`;
+  throw new Error("Asset must have contractId or code+issuer");
+}
+function parseApiQuote(data) {
+  const o = data;
+  return {
+    expectedIn: String(o?.expectedIn ?? o?.amountIn ?? "0"),
+    expectedOut: String(o?.expectedOut ?? o?.amountOut ?? "0"),
+    minOut: String(o?.minOut ?? o?.minimumAmountOut ?? o?.expectedOut ?? "0"),
+    route: Array.isArray(o?.route) ? o.route : Array.isArray(o?.path) ? o.path : [],
+    rawData: data
+  };
+}
+function createSoroSwapDexClient(networkConfig, apiKey) {
+  const networkName = networkConfig.horizonUrl.includes("testnet") ? "testnet" : "mainnet";
+  const key = apiKey ?? process.env.SOROSWAP_API_KEY;
+  async function getQuote(from, to, amount) {
+    const url = `${SOROSWAP_API_BASE}/quote?network=${networkName}`;
+    const body = {
+      assetIn: assetToApiString(from),
+      assetOut: assetToApiString(to),
+      amount: String(amount).trim(),
+      tradeType: "EXACT_IN",
+      protocols: ["soroswap", "phoenix", "aqua"]
+    };
+    const headers = { "Content-Type": "application/json" };
+    if (key) headers["Authorization"] = `Bearer ${key}`;
+    const res = await fetch(url, { method: "POST", headers, body: JSON.stringify(body) });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`SoroSwap quote failed ${res.status}: ${text}`);
+    }
+    return parseApiQuote(await res.json());
+  }
+  async function executeSwap(secretKey, quote) {
+    if (!key) throw new Error("executeSwap requires SOROSWAP_API_KEY");
+    const keypair = Keypair.fromSecret(secretKey.trim());
+    const fromAddress = keypair.publicKey();
+    const buildUrl = `${SOROSWAP_API_BASE}/quote/build?network=${networkName}`;
+    const buildRes = await fetch(buildUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${key}` },
+      body: JSON.stringify({ quote: quote.rawData ?? quote, from: fromAddress, to: fromAddress })
+    });
+    if (!buildRes.ok) throw new Error(`SoroSwap build failed ${buildRes.status}: ${await buildRes.text()}`);
+    const buildData = await buildRes.json();
+    const xdrBase64 = buildData?.xdr;
+    if (!xdrBase64 || typeof xdrBase64 !== "string") throw new Error("SoroSwap build response missing xdr");
+    const config = getNetworkConfig(networkName);
+    const networkPassphrase = config.horizonUrl.includes("testnet") ? Networks.TESTNET : Networks.PUBLIC;
+    const tx = TransactionBuilder.fromXDR(xdrBase64, networkPassphrase);
+    tx.sign(keypair);
+    const server = new rpc.Server(config.sorobanRpcUrl, { allowHttp: config.sorobanRpcUrl.startsWith("http:") });
+    const sendResult = await server.sendTransaction(tx);
+    if (sendResult.errorResult) throw new Error(`Soroban sendTransaction failed: ${String(sendResult.errorResult)}`);
+    return { hash: sendResult.hash, status: sendResult.status ?? "PENDING" };
+  }
+  return { getQuote, executeSwap };
+}
+
+// src/dex/index.ts
+function createDexClient(networkConfig, apiKey) {
+  return createSoroSwapDexClient(networkConfig, apiKey);
+}
+
+// src/agent.ts
+var StellarAgentKit = class {
+  keypair;
+  network;
+  config;
+  _initialized = false;
+  _dex = null;
+  _horizon = null;
+  constructor(secretKey, network) {
+    this.keypair = Keypair2.fromSecret(secretKey.trim());
+    this.network = network;
+    this.config = getNetworkConfig(network);
+  }
+  /**
+   * Initialize clients (Horizon, Soroban RPC, protocol wrappers).
+   * Call after construction before using protocol methods.
+   */
+  async initialize() {
+    this._horizon = new Horizon.Server(this.config.horizonUrl);
+    this._dex = createDexClient(this.config, process.env.SOROSWAP_API_KEY);
+    this._initialized = true;
+    return this;
+  }
+  ensureInitialized() {
+    if (!this._initialized || !this._dex) {
+      throw new Error("StellarAgentKit not initialized. Call await agent.initialize() first.");
+    }
+  }
+  // ─── DEX Operations (mirror Mantle agniSwap / executeSwap) ─────────────────
+  /**
+   * Get a swap quote (exact-in). Uses SoroSwap aggregator (SoroSwap, Phoenix, Aqua).
+   */
+  async dexGetQuote(fromAsset, toAsset, amount) {
+    this.ensureInitialized();
+    return this._dex.getQuote(fromAsset, toAsset, amount);
+  }
+  /**
+   * Execute a swap using a prior quote.
+   */
+  async dexSwap(quote) {
+    this.ensureInitialized();
+    return this._dex.executeSwap(this.keypair.secret(), quote);
+  }
+  /**
+   * One-shot: get quote and execute swap (convenience).
+   */
+  async dexSwapExactIn(fromAsset, toAsset, amount) {
+    const quote = await this.dexGetQuote(fromAsset, toAsset, amount);
+    return this.dexSwap(quote);
+  }
+  // ─── Payments (Horizon) ────────────────────────────────────────────────────
+  /**
+   * Send a native or custom-asset payment (Horizon).
+   * @param to - Destination account (G...)
+   * @param amount - Amount in display units (e.g. "10" for 10 XLM)
+   * @param assetCode - Optional; omit for native XLM
+   * @param assetIssuer - Optional; required if assetCode is set
+   */
+  async sendPayment(to, amount, assetCode, assetIssuer) {
+    this.ensureInitialized();
+    if (!this._horizon) throw new Error("Horizon not initialized");
+    const networkPassphrase = this.network === "testnet" ? Networks2.TESTNET : Networks2.PUBLIC;
+    const sourceAccount = await this._horizon.loadAccount(this.keypair.publicKey());
+    const asset = assetCode && assetIssuer ? new Asset(assetCode, assetIssuer) : Asset.native();
+    const tx = new TransactionBuilder2(sourceAccount, {
+      fee: "100",
+      networkPassphrase
+    }).addOperation(Operation.payment({ destination: to, asset, amount })).setTimeout(180).build();
+    tx.sign(this.keypair);
+    const result = await this._horizon.submitTransaction(tx);
+    return { hash: result.hash };
+  }
+  // ─── Placeholders for lending / oracle / cross-chain (plug later) ────────────
+  // async lendingSupply(asset: DexAsset, amount: string): Promise<{ hash: string }> { ... }
+  // async lendingBorrow(asset: DexAsset, amount: string): Promise<{ hash: string }> { ... }
+  // async getPrice(assetOrFeedId: string): Promise<{ price: string }> { ... }
+  // async crossChainSwap(...): Promise<SwapResult> { ... }
+};
+
+// src/config/assets.ts
+var TESTNET_ASSETS = {
+  XLM: { contractId: "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC" },
+  USDC: { contractId: "CBBHRKEP5M3NUDRISGLJKGHDHX3DA2CN2AZBQY6WLVUJ7VNLGSKBDUCM" },
+  /** Classic testnet USDC */
+  AUSDC: { code: "AUSDC", issuer: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN" }
+};
+var MAINNET_ASSETS = {
+  XLM: { contractId: "CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA" },
+  USDC: { contractId: "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75" }
+};
+var SOROSWAP_AGGREGATOR = {
+  testnet: "CCJUD55AG6W5HAI5LRVNKAE5WDP5XGZBUDS5WNTIVDU7O264UZZE7BRD",
+  mainnet: "CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH"
+};
+export {
+  MAINNET_ASSETS,
+  SOROSWAP_AGGREGATOR,
+  StellarAgentKit,
+  TESTNET_ASSETS,
+  createDexClient,
+  getNetworkConfig,
+  networks
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent.ts","../src/config/networks.ts","../src/dex/soroSwap.ts","../src/dex/index.ts","../src/config/assets.ts"],"sourcesContent":["/**\n * StellarAgentKit – unified DeFi agent (MNTAgentKit-style API for Stellar).\n * Constructor(secretKey, network) + initialize() then protocol methods.\n */\n\nimport { Keypair, Asset, TransactionBuilder, Operation, Networks, Horizon } from \"@stellar/stellar-sdk\";\nimport { getNetworkConfig, type NetworkConfig } from \"./config/networks.js\";\nimport { createDexClient, type DexAsset, type QuoteResult, type SwapResult } from \"./dex/index.js\";\n\nexport type StellarNetwork = \"mainnet\" | \"testnet\";\n\nexport class StellarAgentKit {\n  public readonly keypair: Keypair;\n  public readonly network: StellarNetwork;\n  public readonly config: NetworkConfig;\n  private _initialized = false;\n  private _dex: ReturnType<typeof createDexClient> | null = null;\n  private _horizon: Horizon.Server | null = null;\n\n  constructor(secretKey: string, network: StellarNetwork) {\n    this.keypair = Keypair.fromSecret(secretKey.trim());\n    this.network = network;\n    this.config = getNetworkConfig(network);\n  }\n\n  /**\n   * Initialize clients (Horizon, Soroban RPC, protocol wrappers).\n   * Call after construction before using protocol methods.\n   */\n  async initialize(): Promise<this> {\n    this._horizon = new Horizon.Server(this.config.horizonUrl);\n    this._dex = createDexClient(this.config, process.env.SOROSWAP_API_KEY);\n    this._initialized = true;\n    return this;\n  }\n\n  private ensureInitialized(): void {\n    if (!this._initialized || !this._dex) {\n      throw new Error(\"StellarAgentKit not initialized. Call await agent.initialize() first.\");\n    }\n  }\n\n  // ─── DEX Operations (mirror Mantle agniSwap / executeSwap) ─────────────────\n\n  /**\n   * Get a swap quote (exact-in). Uses SoroSwap aggregator (SoroSwap, Phoenix, Aqua).\n   */\n  async dexGetQuote(\n    fromAsset: DexAsset,\n    toAsset: DexAsset,\n    amount: string\n  ): Promise<QuoteResult> {\n    this.ensureInitialized();\n    return this._dex!.getQuote(fromAsset, toAsset, amount);\n  }\n\n  /**\n   * Execute a swap using a prior quote.\n   */\n  async dexSwap(quote: QuoteResult): Promise<SwapResult> {\n    this.ensureInitialized();\n    return this._dex!.executeSwap(this.keypair.secret(), quote);\n  }\n\n  /**\n   * One-shot: get quote and execute swap (convenience).\n   */\n  async dexSwapExactIn(\n    fromAsset: DexAsset,\n    toAsset: DexAsset,\n    amount: string\n  ): Promise<SwapResult> {\n    const quote = await this.dexGetQuote(fromAsset, toAsset, amount);\n    return this.dexSwap(quote);\n  }\n\n  // ─── Payments (Horizon) ────────────────────────────────────────────────────\n\n  /**\n   * Send a native or custom-asset payment (Horizon).\n   * @param to - Destination account (G...)\n   * @param amount - Amount in display units (e.g. \"10\" for 10 XLM)\n   * @param assetCode - Optional; omit for native XLM\n   * @param assetIssuer - Optional; required if assetCode is set\n   */\n  async sendPayment(\n    to: string,\n    amount: string,\n    assetCode?: string,\n    assetIssuer?: string\n  ): Promise<{ hash: string }> {\n    this.ensureInitialized();\n    if (!this._horizon) throw new Error(\"Horizon not initialized\");\n\n    const networkPassphrase =\n      this.network === \"testnet\" ? Networks.TESTNET : Networks.PUBLIC;\n    const sourceAccount = await this._horizon.loadAccount(this.keypair.publicKey());\n\n    const asset =\n      assetCode && assetIssuer\n        ? new Asset(assetCode, assetIssuer)\n        : Asset.native();\n\n    const tx = new TransactionBuilder(sourceAccount, {\n      fee: \"100\",\n      networkPassphrase,\n    })\n      .addOperation(Operation.payment({ destination: to, asset, amount }))\n      .setTimeout(180)\n      .build();\n\n    tx.sign(this.keypair);\n    const result = await this._horizon.submitTransaction(tx);\n    return { hash: result.hash };\n  }\n\n  // ─── Placeholders for lending / oracle / cross-chain (plug later) ────────────\n\n  // async lendingSupply(asset: DexAsset, amount: string): Promise<{ hash: string }> { ... }\n  // async lendingBorrow(asset: DexAsset, amount: string): Promise<{ hash: string }> { ... }\n  // async getPrice(assetOrFeedId: string): Promise<{ price: string }> { ... }\n  // async crossChainSwap(...): Promise<SwapResult> { ... }\n}\n","import { z } from \"zod\";\n\nexport const NetworkConfigSchema = z.object({\n  horizonUrl: z.string().url(),\n  sorobanRpcUrl: z.string().url(),\n  friendbotUrl: z.string().url().optional(),\n});\n\nexport type NetworkConfig = z.infer<typeof NetworkConfigSchema>;\n\nexport const testnet: NetworkConfig = {\n  horizonUrl: \"https://horizon-testnet.stellar.org\",\n  sorobanRpcUrl: \"https://soroban-testnet.stellar.org\",\n  friendbotUrl: \"https://friendbot.stellar.org\",\n};\n\nexport const mainnet: NetworkConfig = {\n  horizonUrl: \"https://horizon.stellar.org\",\n  sorobanRpcUrl: \"https://soroban-rpc.mainnet.stellar.gateway.fm\",\n};\n\nexport const networks = { testnet, mainnet } as const;\nexport type NetworkName = keyof typeof networks;\n\nexport function getNetworkConfig(name: string): NetworkConfig {\n  const parsed = z.enum([\"testnet\", \"mainnet\"]).safeParse(name);\n  if (!parsed.success) throw new Error(`Invalid network: ${name}. Use \"testnet\" or \"mainnet\".`);\n  return networks[parsed.data];\n}\n","/**\n * SoroSwap DEX client – quote via API, build + sign + submit for executeSwap.\n */\n\nimport { Keypair, TransactionBuilder, Networks } from \"@stellar/stellar-sdk\";\nimport { rpc } from \"@stellar/stellar-sdk\";\nimport type { NetworkConfig } from \"../config/networks.js\";\nimport { getNetworkConfig, type NetworkName } from \"../config/networks.js\";\nimport type { DexAsset, QuoteResult, SwapResult } from \"./types.js\";\n\nconst SOROSWAP_API_BASE = \"https://api.soroswap.finance\";\n\nfunction assetToApiString(asset: DexAsset): string {\n  if (asset.contractId) return asset.contractId;\n  if (asset.code && asset.issuer) return `${asset.code}:${asset.issuer}`;\n  throw new Error(\"Asset must have contractId or code+issuer\");\n}\n\nfunction parseApiQuote(data: unknown): QuoteResult {\n  const o = data as Record<string, unknown>;\n  return {\n    expectedIn: String(o?.expectedIn ?? o?.amountIn ?? \"0\"),\n    expectedOut: String(o?.expectedOut ?? o?.amountOut ?? \"0\"),\n    minOut: String(o?.minOut ?? o?.minimumAmountOut ?? o?.expectedOut ?? \"0\"),\n    route: Array.isArray(o?.route) ? (o.route as string[]) : Array.isArray(o?.path) ? (o.path as string[]) : [],\n    rawData: data,\n  };\n}\n\nexport function createSoroSwapDexClient(\n  networkConfig: NetworkConfig,\n  apiKey?: string\n): { getQuote: (from: DexAsset, to: DexAsset, amount: string) => Promise<QuoteResult>; executeSwap: (secretKey: string, quote: QuoteResult) => Promise<SwapResult> } {\n  const networkName: NetworkName = networkConfig.horizonUrl.includes(\"testnet\") ? \"testnet\" : \"mainnet\";\n  const key = apiKey ?? process.env.SOROSWAP_API_KEY;\n\n  async function getQuote(from: DexAsset, to: DexAsset, amount: string): Promise<QuoteResult> {\n    const url = `${SOROSWAP_API_BASE}/quote?network=${networkName}`;\n    const body = {\n      assetIn: assetToApiString(from),\n      assetOut: assetToApiString(to),\n      amount: String(amount).trim(),\n      tradeType: \"EXACT_IN\",\n      protocols: [\"soroswap\", \"phoenix\", \"aqua\"],\n    };\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (key) headers[\"Authorization\"] = `Bearer ${key}`;\n    const res = await fetch(url, { method: \"POST\", headers, body: JSON.stringify(body) });\n    if (!res.ok) {\n      const text = await res.text();\n      throw new Error(`SoroSwap quote failed ${res.status}: ${text}`);\n    }\n    return parseApiQuote(await res.json());\n  }\n\n  async function executeSwap(secretKey: string, quote: QuoteResult): Promise<SwapResult> {\n    if (!key) throw new Error(\"executeSwap requires SOROSWAP_API_KEY\");\n    const keypair = Keypair.fromSecret(secretKey.trim());\n    const fromAddress = keypair.publicKey();\n    const buildUrl = `${SOROSWAP_API_BASE}/quote/build?network=${networkName}`;\n    const buildRes = await fetch(buildUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\", Authorization: `Bearer ${key}` },\n      body: JSON.stringify({ quote: quote.rawData ?? quote, from: fromAddress, to: fromAddress }),\n    });\n    if (!buildRes.ok) throw new Error(`SoroSwap build failed ${buildRes.status}: ${await buildRes.text()}`);\n    const buildData = (await buildRes.json()) as { xdr?: string };\n    const xdrBase64 = buildData?.xdr;\n    if (!xdrBase64 || typeof xdrBase64 !== \"string\") throw new Error(\"SoroSwap build response missing xdr\");\n    const config = getNetworkConfig(networkName);\n    const networkPassphrase = config.horizonUrl.includes(\"testnet\") ? Networks.TESTNET : Networks.PUBLIC;\n    const tx = TransactionBuilder.fromXDR(xdrBase64, networkPassphrase);\n    tx.sign(keypair);\n    const server = new rpc.Server(config.sorobanRpcUrl, { allowHttp: config.sorobanRpcUrl.startsWith(\"http:\") });\n    const sendResult = await server.sendTransaction(tx);\n    if (sendResult.errorResult) throw new Error(`Soroban sendTransaction failed: ${String(sendResult.errorResult)}`);\n    return { hash: sendResult.hash, status: sendResult.status ?? \"PENDING\" };\n  }\n\n  return { getQuote, executeSwap };\n}\n","/**\n * DEX module – swap, quote, aggregator (SoroSwap).\n * Pluggable: add more DEXes by implementing DexClient.\n */\n\nimport type { NetworkConfig } from \"../config/networks.js\";\nimport type { DexAsset, QuoteResult, SwapResult } from \"./types.js\";\nimport { createSoroSwapDexClient } from \"./soroSwap.js\";\n\nexport type { DexAsset, QuoteResult, SwapResult } from \"./types.js\";\nexport { createSoroSwapDexClient } from \"./soroSwap.js\";\n\nexport interface DexClient {\n  getQuote(fromAsset: DexAsset, toAsset: DexAsset, amount: string): Promise<QuoteResult>;\n  executeSwap(secretKey: string, quote: QuoteResult): Promise<SwapResult>;\n}\n\n/**\n * Build a DEX client for the given network (SoroSwap aggregator).\n */\nexport function createDexClient(networkConfig: NetworkConfig, apiKey?: string): DexClient {\n  return createSoroSwapDexClient(networkConfig, apiKey);\n}\n","/**\n * Stellar asset identifiers and contract addresses.\n * Centralized for mainnet/testnet (mirrors Mantle DevKit \"Token Addresses\").\n */\n\nexport type StellarAsset = { code: string; issuer: string } | { contractId: string };\n\nexport const TESTNET_ASSETS = {\n  XLM: { contractId: \"CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC\" },\n  USDC: { contractId: \"CBBHRKEP5M3NUDRISGLJKGHDHX3DA2CN2AZBQY6WLVUJ7VNLGSKBDUCM\" },\n  /** Classic testnet USDC */\n  AUSDC: { code: \"AUSDC\", issuer: \"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN\" },\n} as const;\n\nexport const MAINNET_ASSETS = {\n  XLM: { contractId: \"CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA\" },\n  USDC: { contractId: \"CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75\" },\n} as const;\n\nexport const SOROSWAP_AGGREGATOR = {\n  testnet: \"CCJUD55AG6W5HAI5LRVNKAE5WDP5XGZBUDS5WNTIVDU7O264UZZE7BRD\",\n  mainnet: \"CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH\",\n} as const;\n"],"mappings":"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","names":["Keypair","TransactionBuilder","Networks","Keypair","Networks","TransactionBuilder"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "stellar-agent-kit",
+  "version": "1.0.0",
+  "description": "Unified TypeScript SDK for Stellar DeFi – DEX, lending, oracles, payments",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "stellar",
+    "soroban",
+    "defi",
+    "dex",
+    "swap",
+    "lending",
+    "oracle",
+    "agent",
+    "sdk",
+    "typescript"
+  ],
+  "dependencies": {
+    "@stellar/stellar-sdk": "^14.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codewmilan/stellar-agent-kit.git"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}