@lombard.finance/sdk-agent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Lombard Finance
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,183 @@
+# @lombard.finance/sdk-agent
+
+AI agent tools for the [Lombard protocol](https://lombard.finance). Give any LLM the ability to stake Bitcoin, check balances, deploy to DeFi vaults, and interact with Morpho Blue lending markets.
+
+Framework-agnostic core with ready-made adapters for [Vercel AI SDK](https://sdk.vercel.ai/) and [LangChain](https://js.langchain.com/).
+
+## Installation
+
+```bash
+npm install @lombard.finance/sdk-agent
+# or
+yarn add @lombard.finance/sdk-agent
+```
+
+### Peer Dependencies
+
+`viem` is required. Framework adapters are optional, install whichever you use:
+
+```bash
+# Required
+npm install viem
+
+# For Vercel AI SDK
+npm install ai
+
+# For LangChain
+npm install @langchain/core
+```
+
+## Quick Start
+
+### Vercel AI SDK
+
+```typescript
+import { lombardTools } from "@lombard.finance/sdk-agent/vercel";
+import { LOMBARD_SYSTEM_PROMPT } from "@lombard.finance/sdk-agent";
+import { streamText } from "ai";
+
+const result = streamText({
+  model: yourModel,
+  system: LOMBARD_SYSTEM_PROMPT,
+  tools: lombardTools,
+  messages,
+});
+```
+
+### LangChain
+
+```typescript
+import { lombardLangChainTools } from "@lombard.finance/sdk-agent/langchain";
+import { LOMBARD_SYSTEM_PROMPT } from "@lombard.finance/sdk-agent";
+
+const agent = createReactAgent({
+  llm: yourModel,
+  tools: lombardLangChainTools,
+  messageModifier: LOMBARD_SYSTEM_PROMPT,
+});
+```
+
+### Framework-Agnostic
+
+```typescript
+import { allTools, toolsByName } from "@lombard.finance/sdk-agent";
+
+// allTools: array of all tool definitions
+// toolsByName: record keyed by tool name
+
+// Each tool has:
+// - name, description (for LLM context)
+// - schema (Zod) and parameters (JSON Schema)
+// - execute(params) -> Promise<result>
+```
+
+## Available Tools
+
+### Balances and Rates
+
+| Tool | Description |
+| ---- | ----------- |
+| `get_lbtc_balance` | Check LBTC balance for a wallet on any supported chain |
+| `get_btcb_balance` | Check BTC.b (cross-chain Bitcoin) balance |
+| `get_balance` | Get both LBTC and BTC.b balances in a single call |
+| `get_token_balance` | Check any ERC-20 token balance by contract address |
+| `get_exchange_rate` | Current LBTC/BTC exchange rate and minimum stake amount |
+| `get_lbtc_apy` | Current LBTC base staking APY |
+
+### BTC Staking (Native Bitcoin)
+
+| Tool | Description |
+| ---- | ----------- |
+| `get_deposit_btc_address` | Get a BTC deposit address for staking, or instructions to generate one |
+| `check_fee_authorization` | Check fee authorization status before address generation |
+| `prepare_btc_deposit` | Generate a new BTC deposit address (triggers wallet signing) |
+| `get_deposit_status` | Track deposit confirmations and claimability |
+| `prepare_claim_deposit` | Claim a notarized deposit to mint LBTC |
+
+### Stake and Unstake (EVM)
+
+| Tool | Description |
+| ---- | ----------- |
+| `prepare_stake` | Prepare a BTC.b to LBTC stake transaction |
+| `prepare_unstake` | Prepare an LBTC unstake transaction (to BTC or BTC.b) |
+| `get_unstake_status` | Track unstake and redemption status |
+
+### Bitcoin Earn (Vaults)
+
+| Tool | Description |
+| ---- | ----------- |
+| `get_strategies` | List available yield strategies with APY and TVL |
+| `get_opportunities` | Browse LBTC DeFi opportunities across protocols |
+| `get_vault_positions` | Check Bitcoin Earn positions (shares and LBTC value) |
+| `prepare_deploy_to_vault` | Deploy LBTC into Bitcoin Earn for additional yield |
+| `prepare_vault_withdrawal` | Withdraw from Bitcoin Earn |
+
+### Morpho Blue (Lending and Borrowing)
+
+| Tool | Description |
+| ---- | ----------- |
+| `get_morpho_lbtc_markets` | List Morpho Blue markets where LBTC is collateral |
+| `prepare_morpho_supply_collateral` | Supply LBTC as collateral on Morpho Blue |
+| `prepare_morpho_borrow` | Borrow against LBTC collateral |
+| `prepare_morpho_repay` | Repay borrowed assets |
+| `get_morpho_position` | Check collateral, borrows, LTV, and health status |
+
+## System Prompt
+
+The package includes `LOMBARD_SYSTEM_PROMPT`, a curated prompt that teaches any LLM how to guide users through:
+
+- Native BTC staking (deposit, confirm, claim LBTC)
+- BTC.b to LBTC staking on EVM chains
+- Yield strategies and Bitcoin Earn deployment
+- Morpho Blue collateral supply and borrowing
+- Error handling and common edge cases
+
+Use it as-is or extend it with your own context:
+
+```typescript
+import { LOMBARD_SYSTEM_PROMPT } from "@lombard.finance/sdk-agent";
+
+const customPrompt = `${LOMBARD_SYSTEM_PROMPT}\n\nAdditional context: ...`;
+```
+
+## Supported Chains
+
+| Chain | Chain ID | Environment |
+| ----- | -------- | ----------- |
+| Ethereum | 1 | Production |
+| Base | 8453 | Production |
+| Sepolia | 11155111 | Testnet |
+| Base Sepolia | 84532 | Testnet |
+
+## Architecture
+
+Tools follow a **read vs. write** pattern:
+
+- **Read tools** execute immediately and return current state (balances, rates, statuses, market data)
+- **Write tools** return transaction parameters for the user's wallet to sign (no private keys needed)
+
+Every tool definition includes both a **Zod schema** (for TypeScript and frameworks that accept Zod) and a **JSON Schema** (for everything else):
+
+```typescript
+import {
+  StakeZod,           // Zod schema
+  StakeSchema,        // JSON Schema equivalent
+} from "@lombard.finance/sdk-agent";
+```
+
+## Configuration
+
+| Variable | Default | Description |
+| -------- | ------- | ----------- |
+| `LOMBARD_PARTNER_ID` | none | Partner ID for BTC deposit address generation |
+| `LOMBARD_BFF_URL` | `https://bff.prod.lombard-fi.com` | Backend API URL |
+
+## Requirements
+
+- **Node.js**: 18+
+- **TypeScript**: 5.0+
+- **viem**: 2.21+
+
+## License
+
+MIT

package/dist/assets.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Canonical glossary of Lombard-related on-chain assets.
+ *
+ * The SDK keeps the source of truth for token addresses (getLbtcContractAddresses,
+ * BTCE_VAULT_CONTRACTS, getTokenContractInfo). This module is the agent's
+ * structured awareness of *what each asset is conceptually* — which one is
+ * yield-bearing, which one is just bridged BTC, which one is the vault share —
+ * so the LLM never has to guess and never tells the user "I'm not familiar
+ * with that token."
+ *
+ * Anything new added to the SDK that the agent should advertise should be
+ * added here. The `get_token_info` tool reads from this module, and the
+ * glossary string is appended to the system prompt at module load.
+ */
+import { type ChainId } from "@lombard.finance/sdk";
+export interface LombardAsset {
+    /** Canonical short symbol (LBTC, BTC.b, BTCe, ...). */
+    symbol: string;
+    /** Other names the LLM might encounter in conversation. */
+    aliases: string[];
+    /** Full human-readable name. */
+    name: string;
+    /** One-sentence summary the LLM can quote when asked "what is X?". */
+    description: string;
+    /** Whether Lombard issues this asset (vs. a third-party token we surface). */
+    isLombardIssued: boolean;
+    /** Whether holding the asset accrues yield over time. */
+    isYieldBearing: boolean;
+    decimals: number;
+    /**
+     * Known per-chain addresses, keyed by EVM chain ID. May be partial: assets
+     * deployed on chains not enumerated here are still discoverable through
+     * get_token_info's address argument or the SDK's getTokenContractInfo.
+     */
+    addresses: Partial<Record<number, string>>;
+    /** Optional extra notes for the LLM. */
+    notes?: string;
+}
+/**
+ * Lombard's user-facing asset roster. Order is intentional: assets users
+ * interact with most directly come first.
+ */
+export declare const LOMBARD_ASSETS: LombardAsset[];
+/**
+ * Resolves a free-text query to a single LombardAsset, matching against
+ * canonical symbol first, then aliases (case-insensitive). Returns undefined
+ * if no match.
+ */
+export declare function resolveAssetByName(query: string): LombardAsset | undefined;
+/**
+ * Resolves a contract address (case-insensitive) to a LombardAsset, scoped
+ * to the given chainId. Only returns a hit when the address is in the
+ * asset's pre-computed map; callers wanting to resolve arbitrary addresses
+ * should fall back to getTokenContractInfo.
+ */
+export declare function resolveAssetByAddress(chainId: ChainId | number, address: string): LombardAsset | undefined;
+/** Builds the markdown glossary that's appended to the system prompt. */
+export declare function buildAssetGlossary(): string;
+/** Pre-built glossary string (computed once at module load). */
+export declare const LOMBARD_ASSETS_GLOSSARY: string;
+//# sourceMappingURL=assets.d.ts.map

package/dist/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAEL,KAAK,OAAO,EAGb,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAsCxC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAQ1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,EAAE,MAAM,GACd,YAAY,GAAG,SAAS,CAQ1B;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,IAAI,MAAM,CAe3C;AAED,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,QAAuB,CAAC"}

package/dist/chains.d.ts

@@ -0,0 +1,11 @@
+import { ChainId, Env } from "@lombard.finance/sdk";
+import type { Chain } from "viem";
+export interface ChainConfig {
+    chain: Chain;
+    chainId: ChainId;
+    env: Env;
+    name: string;
+}
+export declare const SUPPORTED_CHAINS: Record<number, ChainConfig>;
+export declare function getChainConfig(chainId: number): ChainConfig;
+//# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAGlC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAKxD,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAO3D"}

package/dist/index.cjs

@@ -0,0 +1,78 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./tools.cjs"),t=`You are an assistant for the Lombard protocol. Lombard issues LBTC, a yield-bearing receipt token for BTC staked via Babylon. LBTC accrues yield, so 1 LBTC is always worth more than 1 BTC; never assume 1:1 — always fetch the live rate with get_exchange_rate.
+
+Networks: Ethereum and Base are production. Sepolia and Base Sepolia are development/test environments. Bitcoin Earn (vault yield) and strategy data are mainnet-only.
+
+# Core rules
+
+Validate first, act second. Never call a prepare_* tool with missing, placeholder, or inferred values. If a required field is absent (e.g. a Bitcoin recipient address for an LBTC → BTC unstake) or you are not sure of a constraint (minimum amount, address format), ask the user. Do not pull values from prior context unless the user just referenced them. If a prepare_* tool returns "valid: false", list the missing or invalid fields verbatim, ask the user to provide them, and stop — do not retry until the user supplies them.
+
+Use the wallet's connected chain as default. Each turn this prompt is extended with the user's wallet context (address, chainId, chainName). When the user asks for a balance / deposit / operation without naming a chain, use the connected chain and say so ("Showing your balance on {chainName}. Want me to check the other supported networks too?"). Do not silently default to Ethereum mainnet.
+
+Emit full data. Never truncate or abbreviate addresses, transaction hashes, amounts, or market IDs. Always emit the canonical full-length value. The chat UI handles display formatting.
+
+Stay in-app. Complete all operations here. Never tell the user to open Etherscan, the Lombard web app, Morpho's website, or any other external interface — unless it is the only path to recover from a documented failure mode.
+
+Concise replies. Lead with the answer. Skip filler ("Let me check…", "I'll look into…"). After a step completes, briefly propose the next logical action and offer to do it.
+
+# Canonical URLs (never improvise)
+
+Use these URLs verbatim when recovery requires linking the user off-app. Do NOT shorten, abbreviate, or guess URLs from memory — only these strings are valid:
+
+- Lombard web app: https://www.lombard.finance/app/
+- Lombard docs: https://docs.lombard.finance
+- Etherscan (Ethereum mainnet): https://etherscan.io
+- Etherscan (Sepolia): https://sepolia.etherscan.io
+- Basescan (Base mainnet): https://basescan.org
+- Basescan (Base Sepolia): https://sepolia.basescan.org
+
+If a recovery path requires a URL not listed above, say so and stop — do not invent one. Specifically, "app.lombard.finance" is NOT a valid host; the correct host is "www.lombard.finance" with the "/app/" path.
+
+# Workflows
+
+Native BTC deposits (two distinct flows — pick based on what the user wants to receive):
+
+(A) BTC → LBTC (yield-bearing): the user receives LBTC, which accrues Babylon staking yield over time.
+1. Call get_deposit_btc_address. If an address is returned, display it. Stop — do not call prepare_btc_deposit.
+2. If no address exists, call check_fee_authorization. If hasValidSignature is true, tell the user the wallet will only need to confirm the address (no fresh fee signature).
+3. Call prepare_btc_deposit. The wallet prompts only when fee auth is missing or expired.
+4. After the address is returned, tell the user to send BTC, track with get_deposit_status, and use prepare_claim_deposit once claimable.
+
+(B) BTC → BTC.b (cross-chain wrapped BTC, NOT yield-bearing): the user receives BTC.b on the destination EVM chain.
+1. Call prepare_btc_to_btcb_deposit with the user's address and chainId. The wallet prompts for the required authorization, then a unique BTC deposit address is generated.
+2. Tell the user to send BTC and track via get_deposit_status.
+
+When the user says "I want to deposit BTC", ask which output they want (LBTC or BTC.b) and explain the difference: LBTC accrues yield; BTC.b is cross-chain wrapped BTC, not yield-bearing. Never tell the user BTC → BTC.b is unsupported — it is supported via prepare_btc_to_btcb_deposit.
+
+EVM stake / unstake / redeem:
+- prepare_stake: BTC.b → LBTC on the connected chain.
+- prepare_unstake: LBTC → BTC or BTC.b. When outputAsset is "BTC", you MUST collect a Bitcoin destination address from the user before calling the tool. Valid formats: bc1.../1.../3... on mainnet; tb1.../m.../n.../2... on Sepolia or Base Sepolia. Numeric strings, EVM addresses, or addresses inferred from earlier turns are invalid — re-prompt the user.
+- prepare_redeem_btcb: BTC.b → native BTC. Use this when the user holds BTC.b and wants real Bitcoin back (not LBTC). Same Bitcoin recipient address validation rules as prepare_unstake to BTC. Do NOT use prepare_unstake for BTC.b; prepare_unstake operates on LBTC only.
+
+Bitcoin Earn withdrawals (only one active withdrawal per user per vault):
+- prepare_vault_withdrawal performs a pre-flight check via getEarnWithdrawals. If an active withdrawal already exists, it returns valid:false with the existing withdrawal's details (shareAmount, txHash, deadline). Tell the user about that withdrawal and offer prepare_cancel_withdrawal — do NOT call prepare_vault_withdrawal again until the existing one is cancelled.
+- prepare_cancel_withdrawal looks up the user's active withdrawal and returns the cancel transaction parameters. If there is no active withdrawal it refuses with valid:false; surface that to the user instead of guessing.
+
+Yield / DeFi:
+1. get_opportunities — cross-protocol LBTC and BTC.b opportunities.
+2. get_strategies — Bitcoin Earn (mainnet-only): APY + TVL.
+3. get_morpho_lbtc_markets — Morpho lending markets where LBTC is collateral.
+Present trade-offs and let the user choose. Bitcoin Earn is Lombard's vault product (built on the Veda vault protocol); always refer to it as "Bitcoin Earn".
+
+Morpho Blue:
+1. get_morpho_lbtc_markets to list markets (APY, TVL, LLTV).
+2. prepare_morpho_supply_collateral with the chosen market ID and amount.
+3. Immediately offer prepare_morpho_borrow afterward.
+4. Use get_morpho_position to check positions after writes.
+
+Token balance by name (e.g. "my USDC balance"): call get_morpho_lbtc_markets first to find the token's loanAssetAddress, then call get_token_balance with that address.
+
+# Error handling
+
+- "bad captcha" / 401: the partner ID isn't accepted on this network. Direct the user to https://www.lombard.finance/app/ (use exactly this URL — see Canonical URLs).
+- HTTP 500 / "Internal Server Error" / "code: 13": a backend issue on the deposit-address service, usually transient on testnet. Tell the user it's a backend issue, suggest retrying in a moment, and offer https://www.lombard.finance/app/ as a workaround. Do not retry the tool more than twice.
+- "Active signature already exists for this user": the user is already authorized. Call check_fee_authorization to confirm, then call get_deposit_btc_address — they do not need to sign again.
+- Fee authorization expired: call prepare_btc_deposit to re-sign.
+- Insufficient balance / chain mismatch: explain plainly and suggest the fix (top up / switch network).
+- Tool returns "valid: false": list the missing or invalid fields verbatim and ask the user to provide them.`,a=`${t}
+
+${e.LOMBARD_ASSETS_GLOSSARY}`;exports.AddressAndChainSchema=e.AddressAndChainSchema;exports.AddressAndChainZod=e.AddressAndChainZod;exports.BalanceSchema=e.BalanceSchema;exports.BalanceZod=e.BalanceZod;exports.CHAIN_ID_DESCRIPTION=e.CHAIN_ID_DESCRIPTION;exports.ClaimDepositSchema=e.ClaimDepositSchema;exports.ClaimDepositZod=e.ClaimDepositZod;exports.DeployToVaultSchema=e.DeployToVaultSchema;exports.DeployToVaultZod=e.DeployToVaultZod;exports.DepositBtcSchema=e.DepositBtcSchema;exports.DepositBtcZod=e.DepositBtcZod;exports.ExchangeRateSchema=e.ExchangeRateSchema;exports.ExchangeRateZod=e.ExchangeRateZod;exports.LOMBARD_ASSETS=e.LOMBARD_ASSETS;exports.LOMBARD_ASSETS_GLOSSARY=e.LOMBARD_ASSETS_GLOSSARY;exports.LbtcApySchema=e.LbtcApySchema;exports.LbtcApyZod=e.LbtcApyZod;exports.MorphoBorrowSchema=e.MorphoBorrowSchema;exports.MorphoBorrowZod=e.MorphoBorrowZod;exports.MorphoLbtcMarketsSchema=e.MorphoLbtcMarketsSchema;exports.MorphoLbtcMarketsZod=e.MorphoLbtcMarketsZod;exports.MorphoPositionSchema=e.MorphoPositionSchema;exports.MorphoPositionZod=e.MorphoPositionZod;exports.MorphoRepaySchema=e.MorphoRepaySchema;exports.MorphoRepayZod=e.MorphoRepayZod;exports.MorphoSupplyCollateralSchema=e.MorphoSupplyCollateralSchema;exports.MorphoSupplyCollateralZod=e.MorphoSupplyCollateralZod;exports.OpportunitiesSchema=e.OpportunitiesSchema;exports.OpportunitiesZod=e.OpportunitiesZod;exports.RedeemBtcbSchema=e.RedeemBtcbSchema;exports.RedeemBtcbZod=e.RedeemBtcbZod;exports.SUPPORTED_CHAINS=e.SUPPORTED_CHAINS;exports.StakeSchema=e.StakeSchema;exports.StakeZod=e.StakeZod;exports.StrategiesSchema=e.StrategiesSchema;exports.StrategiesZod=e.StrategiesZod;exports.TokenBalanceSchema=e.TokenBalanceSchema;exports.TokenBalanceZod=e.TokenBalanceZod;exports.TokenInfoSchema=e.TokenInfoSchema;exports.TokenInfoZod=e.TokenInfoZod;exports.UnstakeSchema=e.UnstakeSchema;exports.UnstakeZod=e.UnstakeZod;exports.VaultWithdrawalSchema=e.VaultWithdrawalSchema;exports.VaultWithdrawalZod=e.VaultWithdrawalZod;exports.allTools=e.allTools;exports.amount=e.amount;exports.buildAssetGlossary=e.buildAssetGlossary;exports.chainId=e.chainId;exports.checkFeeAuthorization=e.checkFeeAuthorization;exports.evmAddress=e.evmAddress;exports.getBalance=e.getBalance;exports.getBtcbBalance=e.getBtcbBalance;exports.getChainConfig=e.getChainConfig;exports.getDepositBtcAddress=e.getDepositBtcAddress;exports.getDepositStatusTool=e.getDepositStatusTool;exports.getExchangeRate=e.getExchangeRate;exports.getLbtcApy=e.getLbtcApy;exports.getLbtcBalance=e.getLbtcBalance;exports.getMorphoLbtcMarkets=e.getMorphoLbtcMarkets;exports.getMorphoPosition=e.getMorphoPosition;exports.getOpportunities=e.getOpportunities;exports.getStrategies=e.getStrategies;exports.getTokenBalance=e.getTokenBalance;exports.getTokenInfo=e.getTokenInfo;exports.getUnstakeStatusTool=e.getUnstakeStatusTool;exports.getVaultPositions=e.getVaultPositions;exports.prepareBtcDeposit=e.prepareBtcDeposit;exports.prepareBtcToBtcbDeposit=e.prepareBtcToBtcbDeposit;exports.prepareCancelWithdrawal=e.prepareCancelWithdrawal;exports.prepareClaimDeposit=e.prepareClaimDeposit;exports.prepareDeployToVault=e.prepareDeployToVault;exports.prepareMorphoBorrow=e.prepareMorphoBorrow;exports.prepareMorphoRepay=e.prepareMorphoRepay;exports.prepareMorphoSupplyCollateral=e.prepareMorphoSupplyCollateral;exports.prepareRedeemBtcb=e.prepareRedeemBtcb;exports.prepareStake=e.prepareStake;exports.prepareUnstake=e.prepareUnstake;exports.prepareVaultWithdrawal=e.prepareVaultWithdrawal;exports.resolveAssetByAddress=e.resolveAssetByAddress;exports.resolveAssetByName=e.resolveAssetByName;exports.toolsByName=e.toolsByName;exports.LOMBARD_SYSTEM_PROMPT=a;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { buildAssetGlossary, LOMBARD_ASSETS, LOMBARD_ASSETS_GLOSSARY, type LombardAsset, resolveAssetByAddress, resolveAssetByName, } from "./assets";
+export { type ChainConfig, getChainConfig, SUPPORTED_CHAINS } from "./chains";
+export { LOMBARD_SYSTEM_PROMPT } from "./prompt";
+export { AddressAndChainSchema, AddressAndChainZod, amount, BalanceSchema, BalanceZod, CHAIN_ID_DESCRIPTION, chainId, ClaimDepositSchema, ClaimDepositZod, DeployToVaultSchema, DeployToVaultZod, DepositBtcSchema, DepositBtcZod, evmAddress, ExchangeRateSchema, ExchangeRateZod, LbtcApySchema, LbtcApyZod, MorphoBorrowSchema, MorphoBorrowZod, MorphoLbtcMarketsSchema, MorphoLbtcMarketsZod, MorphoPositionSchema, MorphoPositionZod, MorphoRepaySchema, MorphoRepayZod, MorphoSupplyCollateralSchema, MorphoSupplyCollateralZod, OpportunitiesSchema, OpportunitiesZod, RedeemBtcbSchema, RedeemBtcbZod, StakeSchema, StakeZod, StrategiesSchema, StrategiesZod, TokenBalanceSchema, TokenBalanceZod, TokenInfoSchema, TokenInfoZod, UnstakeSchema, UnstakeZod, VaultWithdrawalSchema, VaultWithdrawalZod, } from "./schemas";
+export { allTools, checkFeeAuthorization, getBalance, getBtcbBalance, getDepositBtcAddress, getDepositStatusTool, getExchangeRate, getLbtcApy, getLbtcBalance, getMorphoLbtcMarkets, getMorphoPosition, getOpportunities, getStrategies, getTokenBalance, getTokenInfo, getUnstakeStatusTool, getVaultPositions, prepareBtcDeposit, prepareBtcToBtcbDeposit, prepareCancelWithdrawal, prepareClaimDeposit, prepareDeployToVault, prepareMorphoBorrow, prepareMorphoRepay, prepareMorphoSupplyCollateral, prepareRedeemBtcb, prepareStake, prepareUnstake, prepareVaultWithdrawal, type ToolDefinition, toolsByName, } from "./tools";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,KAAK,YAAY,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,EACN,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,OAAO,EACP,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,4BAA4B,EAC5B,yBAAyB,EACzB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,KAAK,cAAc,EACnB,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,164 @@
+import { L as e } from "./tools.js";
+import { A as i, a as n, B as l, b as p, C as h, c as d, d as c, D as u, e as m, f, g as w, E as b, h as B, i as g, j as T, k as _, M as y, l as k, m as C, n as v, o as S, p as L, q as A, r as M, s as D, t as E, O as I, u as x, R, v as Z, S as N, w as U, x as V, y as O, z as P, T as W, F as q, G as z, H as Y, U as H, I as F, V as j, J as G, K as $, N as J, P as K, Q, W as X, X as ee, Y as ae, Z as te, _ as se, $ as re, a0 as oe, a1 as ie, a2 as ne, a3 as le, a4 as pe, a5 as he, a6 as de, a7 as ce, a8 as ue, a9 as me, aa as fe, ab as we, ac as be, ad as Be, ae as ge, af as Te, ag as _e, ah as ye, ai as ke, aj as Ce, ak as ve, al as Se, am as Le, an as Ae, ao as Me, ap as De, aq as Ee } from "./tools.js";
+const a = `You are an assistant for the Lombard protocol. Lombard issues LBTC, a yield-bearing receipt token for BTC staked via Babylon. LBTC accrues yield, so 1 LBTC is always worth more than 1 BTC; never assume 1:1 — always fetch the live rate with get_exchange_rate.
+
+Networks: Ethereum and Base are production. Sepolia and Base Sepolia are development/test environments. Bitcoin Earn (vault yield) and strategy data are mainnet-only.
+
+# Core rules
+
+Validate first, act second. Never call a prepare_* tool with missing, placeholder, or inferred values. If a required field is absent (e.g. a Bitcoin recipient address for an LBTC → BTC unstake) or you are not sure of a constraint (minimum amount, address format), ask the user. Do not pull values from prior context unless the user just referenced them. If a prepare_* tool returns "valid: false", list the missing or invalid fields verbatim, ask the user to provide them, and stop — do not retry until the user supplies them.
+
+Use the wallet's connected chain as default. Each turn this prompt is extended with the user's wallet context (address, chainId, chainName). When the user asks for a balance / deposit / operation without naming a chain, use the connected chain and say so ("Showing your balance on {chainName}. Want me to check the other supported networks too?"). Do not silently default to Ethereum mainnet.
+
+Emit full data. Never truncate or abbreviate addresses, transaction hashes, amounts, or market IDs. Always emit the canonical full-length value. The chat UI handles display formatting.
+
+Stay in-app. Complete all operations here. Never tell the user to open Etherscan, the Lombard web app, Morpho's website, or any other external interface — unless it is the only path to recover from a documented failure mode.
+
+Concise replies. Lead with the answer. Skip filler ("Let me check…", "I'll look into…"). After a step completes, briefly propose the next logical action and offer to do it.
+
+# Canonical URLs (never improvise)
+
+Use these URLs verbatim when recovery requires linking the user off-app. Do NOT shorten, abbreviate, or guess URLs from memory — only these strings are valid:
+
+- Lombard web app: https://www.lombard.finance/app/
+- Lombard docs: https://docs.lombard.finance
+- Etherscan (Ethereum mainnet): https://etherscan.io
+- Etherscan (Sepolia): https://sepolia.etherscan.io
+- Basescan (Base mainnet): https://basescan.org
+- Basescan (Base Sepolia): https://sepolia.basescan.org
+
+If a recovery path requires a URL not listed above, say so and stop — do not invent one. Specifically, "app.lombard.finance" is NOT a valid host; the correct host is "www.lombard.finance" with the "/app/" path.
+
+# Workflows
+
+Native BTC deposits (two distinct flows — pick based on what the user wants to receive):
+
+(A) BTC → LBTC (yield-bearing): the user receives LBTC, which accrues Babylon staking yield over time.
+1. Call get_deposit_btc_address. If an address is returned, display it. Stop — do not call prepare_btc_deposit.
+2. If no address exists, call check_fee_authorization. If hasValidSignature is true, tell the user the wallet will only need to confirm the address (no fresh fee signature).
+3. Call prepare_btc_deposit. The wallet prompts only when fee auth is missing or expired.
+4. After the address is returned, tell the user to send BTC, track with get_deposit_status, and use prepare_claim_deposit once claimable.
+
+(B) BTC → BTC.b (cross-chain wrapped BTC, NOT yield-bearing): the user receives BTC.b on the destination EVM chain.
+1. Call prepare_btc_to_btcb_deposit with the user's address and chainId. The wallet prompts for the required authorization, then a unique BTC deposit address is generated.
+2. Tell the user to send BTC and track via get_deposit_status.
+
+When the user says "I want to deposit BTC", ask which output they want (LBTC or BTC.b) and explain the difference: LBTC accrues yield; BTC.b is cross-chain wrapped BTC, not yield-bearing. Never tell the user BTC → BTC.b is unsupported — it is supported via prepare_btc_to_btcb_deposit.
+
+EVM stake / unstake / redeem:
+- prepare_stake: BTC.b → LBTC on the connected chain.
+- prepare_unstake: LBTC → BTC or BTC.b. When outputAsset is "BTC", you MUST collect a Bitcoin destination address from the user before calling the tool. Valid formats: bc1.../1.../3... on mainnet; tb1.../m.../n.../2... on Sepolia or Base Sepolia. Numeric strings, EVM addresses, or addresses inferred from earlier turns are invalid — re-prompt the user.
+- prepare_redeem_btcb: BTC.b → native BTC. Use this when the user holds BTC.b and wants real Bitcoin back (not LBTC). Same Bitcoin recipient address validation rules as prepare_unstake to BTC. Do NOT use prepare_unstake for BTC.b; prepare_unstake operates on LBTC only.
+
+Bitcoin Earn withdrawals (only one active withdrawal per user per vault):
+- prepare_vault_withdrawal performs a pre-flight check via getEarnWithdrawals. If an active withdrawal already exists, it returns valid:false with the existing withdrawal's details (shareAmount, txHash, deadline). Tell the user about that withdrawal and offer prepare_cancel_withdrawal — do NOT call prepare_vault_withdrawal again until the existing one is cancelled.
+- prepare_cancel_withdrawal looks up the user's active withdrawal and returns the cancel transaction parameters. If there is no active withdrawal it refuses with valid:false; surface that to the user instead of guessing.
+
+Yield / DeFi:
+1. get_opportunities — cross-protocol LBTC and BTC.b opportunities.
+2. get_strategies — Bitcoin Earn (mainnet-only): APY + TVL.
+3. get_morpho_lbtc_markets — Morpho lending markets where LBTC is collateral.
+Present trade-offs and let the user choose. Bitcoin Earn is Lombard's vault product (built on the Veda vault protocol); always refer to it as "Bitcoin Earn".
+
+Morpho Blue:
+1. get_morpho_lbtc_markets to list markets (APY, TVL, LLTV).
+2. prepare_morpho_supply_collateral with the chosen market ID and amount.
+3. Immediately offer prepare_morpho_borrow afterward.
+4. Use get_morpho_position to check positions after writes.
+
+Token balance by name (e.g. "my USDC balance"): call get_morpho_lbtc_markets first to find the token's loanAssetAddress, then call get_token_balance with that address.
+
+# Error handling
+
+- "bad captcha" / 401: the partner ID isn't accepted on this network. Direct the user to https://www.lombard.finance/app/ (use exactly this URL — see Canonical URLs).
+- HTTP 500 / "Internal Server Error" / "code: 13": a backend issue on the deposit-address service, usually transient on testnet. Tell the user it's a backend issue, suggest retrying in a moment, and offer https://www.lombard.finance/app/ as a workaround. Do not retry the tool more than twice.
+- "Active signature already exists for this user": the user is already authorized. Call check_fee_authorization to confirm, then call get_deposit_btc_address — they do not need to sign again.
+- Fee authorization expired: call prepare_btc_deposit to re-sign.
+- Insufficient balance / chain mismatch: explain plainly and suggest the fix (top up / switch network).
+- Tool returns "valid: false": list the missing or invalid fields verbatim and ask the user to provide them.`, s = `${a}
+
+${e}`;
+export {
+  i as AddressAndChainSchema,
+  n as AddressAndChainZod,
+  l as BalanceSchema,
+  p as BalanceZod,
+  h as CHAIN_ID_DESCRIPTION,
+  d as ClaimDepositSchema,
+  c as ClaimDepositZod,
+  u as DeployToVaultSchema,
+  m as DeployToVaultZod,
+  f as DepositBtcSchema,
+  w as DepositBtcZod,
+  b as ExchangeRateSchema,
+  B as ExchangeRateZod,
+  g as LOMBARD_ASSETS,
+  e as LOMBARD_ASSETS_GLOSSARY,
+  s as LOMBARD_SYSTEM_PROMPT,
+  T as LbtcApySchema,
+  _ as LbtcApyZod,
+  y as MorphoBorrowSchema,
+  k as MorphoBorrowZod,
+  C as MorphoLbtcMarketsSchema,
+  v as MorphoLbtcMarketsZod,
+  S as MorphoPositionSchema,
+  L as MorphoPositionZod,
+  A as MorphoRepaySchema,
+  M as MorphoRepayZod,
+  D as MorphoSupplyCollateralSchema,
+  E as MorphoSupplyCollateralZod,
+  I as OpportunitiesSchema,
+  x as OpportunitiesZod,
+  R as RedeemBtcbSchema,
+  Z as RedeemBtcbZod,
+  N as SUPPORTED_CHAINS,
+  U as StakeSchema,
+  V as StakeZod,
+  O as StrategiesSchema,
+  P as StrategiesZod,
+  W as TokenBalanceSchema,
+  q as TokenBalanceZod,
+  z as TokenInfoSchema,
+  Y as TokenInfoZod,
+  H as UnstakeSchema,
+  F as UnstakeZod,
+  j as VaultWithdrawalSchema,
+  G as VaultWithdrawalZod,
+  $ as allTools,
+  J as amount,
+  K as buildAssetGlossary,
+  Q as chainId,
+  X as checkFeeAuthorization,
+  ee as evmAddress,
+  ae as getBalance,
+  te as getBtcbBalance,
+  se as getChainConfig,
+  re as getDepositBtcAddress,
+  oe as getDepositStatusTool,
+  ie as getExchangeRate,
+  ne as getLbtcApy,
+  le as getLbtcBalance,
+  pe as getMorphoLbtcMarkets,
+  he as getMorphoPosition,
+  de as getOpportunities,
+  ce as getStrategies,
+  ue as getTokenBalance,
+  me as getTokenInfo,
+  fe as getUnstakeStatusTool,
+  we as getVaultPositions,
+  be as prepareBtcDeposit,
+  Be as prepareBtcToBtcbDeposit,
+  ge as prepareCancelWithdrawal,
+  Te as prepareClaimDeposit,
+  _e as prepareDeployToVault,
+  ye as prepareMorphoBorrow,
+  ke as prepareMorphoRepay,
+  Ce as prepareMorphoSupplyCollateral,
+  ve as prepareRedeemBtcb,
+  Se as prepareStake,
+  Le as prepareUnstake,
+  Ae as prepareVaultWithdrawal,
+  Me as resolveAssetByAddress,
+  De as resolveAssetByName,
+  Ee as toolsByName
+};

package/dist/langchain.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@langchain/core/tools"),e=require("./tools.cjs");function n(o){return t.tool(async a=>JSON.stringify(await o.execute(a)),{name:o.name,description:o.description,schema:o.schema})}const i=e.allTools.map(n);exports.lombardLangChainTools=i;exports.toLangChainTool=n;

package/dist/langchain.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "./tools";
+export declare function toLangChainTool(def: ToolDefinition<any, any>): import("@langchain/core/tools").DynamicStructuredTool<import("zod").ZodType<any, import("zod").ZodTypeDef, any>, any, any, string>;
+export declare const lombardLangChainTools: import("@langchain/core/tools").DynamicStructuredTool<import("zod").ZodType<any, import("zod").ZodTypeDef, any>, any, any, string>[];
+//# sourceMappingURL=langchain.d.ts.map

package/dist/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../src/langchain.ts"],"names":[],"mappings":"AAaA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAGxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,sIAS5D;AAED,eAAO,MAAM,qBAAqB,sIAAgC,CAAC"}

package/dist/langchain.js

@@ -0,0 +1,17 @@
+import { tool as n } from "@langchain/core/tools";
+import { K as t } from "./tools.js";
+function i(o) {
+  return n(
+    async (a) => JSON.stringify(await o.execute(a)),
+    {
+      name: o.name,
+      description: o.description,
+      schema: o.schema
+    }
+  );
+}
+const s = t.map(i);
+export {
+  s as lombardLangChainTools,
+  i as toLangChainTool
+};