@lombard.finance/sdk-agentkit 0.1.0

package/dist/lombardActionProvider.d.ts

@@ -0,0 +1,44 @@
+import "reflect-metadata";
+import { ActionProvider, EvmWalletProvider, type Network } from "@coinbase/agentkit";
+import { z } from "zod";
+import { ClaimDepositSchema, DeployToDefiSchema, GetBtcbBalanceSchema, GetDepositStatusSchema, GetLbtcBalanceSchema, GetLbtcExchangeRateSchema, GetUnstakeStatusSchema, RedeemLbtcToBtcbSchema, StakeBtcbToLbtcSchema, UnstakeLbtcSchema } from "./schemas";
+/**
+ * LombardActionProvider exposes Lombard protocol operations
+ * (stake, unstake, redeem, deploy, claim) as Coinbase AgentKit actions.
+ *
+ * SECURITY: This provider executes real transactions. Configure your wallet
+ * provider with appropriate spending limits. All amounts are validated to be
+ * positive numeric strings under 1000 BTC equivalent.
+ *
+ * Usage:
+ * ```ts
+ * import { lombardActionProvider } from '@lombard.finance/sdk-agentkit';
+ *
+ * const agentkit = await AgentKit.from({
+ *   walletProvider,
+ *   actionProviders: [lombardActionProvider()],
+ * });
+ * ```
+ */
+export declare class LombardActionProvider extends ActionProvider<EvmWalletProvider> {
+    constructor();
+    supportsNetwork: (network: Network) => boolean;
+    stakeBtcbToLbtc(walletProvider: EvmWalletProvider, args: z.infer<typeof StakeBtcbToLbtcSchema>): Promise<string>;
+    unstakeLbtc(walletProvider: EvmWalletProvider, args: z.infer<typeof UnstakeLbtcSchema>): Promise<string>;
+    redeemLbtcToBtcb(walletProvider: EvmWalletProvider, args: z.infer<typeof RedeemLbtcToBtcbSchema>): Promise<string>;
+    deployToDefi(walletProvider: EvmWalletProvider, args: z.infer<typeof DeployToDefiSchema>): Promise<string>;
+    claimDeposit(walletProvider: EvmWalletProvider, args: z.infer<typeof ClaimDepositSchema>): Promise<string>;
+    getLbtcBalance(walletProvider: EvmWalletProvider, args: z.infer<typeof GetLbtcBalanceSchema>): Promise<string>;
+    getBtcbBalance(walletProvider: EvmWalletProvider, args: z.infer<typeof GetBtcbBalanceSchema>): Promise<string>;
+    getLbtcExchangeRate(_walletProvider: EvmWalletProvider, _args: z.infer<typeof GetLbtcExchangeRateSchema>): Promise<string>;
+    getDepositStatusAction(walletProvider: EvmWalletProvider, args: z.infer<typeof GetDepositStatusSchema>): Promise<string>;
+    getUnstakeStatus(walletProvider: EvmWalletProvider, args: z.infer<typeof GetUnstakeStatusSchema>): Promise<string>;
+    /**
+     * Ensures fee authorization is in place for chains that require it.
+     * On Ethereum and Sepolia, staking/unstaking requires an EIP-712 fee
+     * signature stored with the backend before the transaction can proceed.
+     */
+    private ensureFeeAuthorization;
+}
+export declare const lombardActionProvider: () => LombardActionProvider;
+//# sourceMappingURL=lombardActionProvider.d.ts.map

package/dist/lombardActionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lombardActionProvider.d.ts","sourceRoot":"","sources":["../src/lombardActionProvider.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EAEd,iBAAiB,EACjB,KAAK,OAAO,EACb,MAAM,oBAAoB,CAAC;AA0B5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAQnB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,iBAAiB,CAAC;;IAK1E,eAAe,GAAI,SAAS,OAAO,KAAG,OAAO,CAE3C;IAYI,eAAe,CACnB,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC;IA+EZ,WAAW,CACf,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC;IAiFZ,gBAAgB,CACpB,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC;IAmDZ,YAAY,CAChB,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;IA2CZ,YAAY,CAChB,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;IAmEZ,cAAc,CAClB,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAsCZ,cAAc,CAClB,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAuCZ,mBAAmB,CACvB,eAAe,EAAE,iBAAiB,EAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC/C,OAAO,CAAC,MAAM,CAAC;IA8BZ,sBAAsB,CAC1B,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC;IAuDZ,gBAAgB,CACpB,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC;IA2ClB;;;;OAIG;YACW,sBAAsB;CA4CrC;AAED,eAAO,MAAM,qBAAqB,6BAAoC,CAAC"}

package/dist/networks.d.ts

@@ -0,0 +1,43 @@
+import type { Network } from "@coinbase/agentkit";
+import { ChainId } from "@lombard.finance/sdk";
+import { Env } from "@lombard.finance/sdk-common";
+import type { Chain } from "viem";
+/**
+ * Maps AgentKit network IDs to Lombard SDK ChainId values.
+ *
+ * Only includes networks where Lombard contracts are deployed.
+ */
+declare const NETWORK_ID_TO_LOMBARD_CHAIN: Record<string, ChainId>;
+/**
+ * Maps AgentKit network IDs to Lombard SDK Env values.
+ */
+declare const NETWORK_ID_TO_ENV: Record<string, Env>;
+/**
+ * Maps AgentKit network IDs to viem `Chain` objects, for callers that need
+ * to construct a wallet/public client outside of the action provider.
+ */
+export declare const NETWORK_ID_TO_VIEM_CHAIN: Record<string, Chain>;
+export interface ResolvedNetwork {
+    chainId: ChainId;
+    env: Env;
+    networkId: string;
+}
+/**
+ * Resolves an AgentKit Network to Lombard SDK chain parameters.
+ *
+ * @returns ResolvedNetwork or null if the network is not supported
+ */
+export declare function resolveNetwork(network: Network): ResolvedNetwork | null;
+/**
+ * Resolves a user-supplied chain name string to Lombard SDK chain parameters.
+ *
+ * Accepts both AgentKit network IDs (e.g., "ethereum-mainnet") and
+ * friendly names (e.g., "ethereum", "base-sepolia").
+ */
+export declare function resolveChainName(chainName: string): ResolvedNetwork | null;
+/**
+ * Checks if a given AgentKit Network is supported by the Lombard provider.
+ */
+export declare function isLombardSupportedNetwork(network: Network): boolean;
+export { NETWORK_ID_TO_ENV, NETWORK_ID_TO_LOMBARD_CHAIN };
+//# sourceMappingURL=networks.d.ts.map

package/dist/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAGlC;;;;GAIG;AACH,QAAA,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAKxD,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAK1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAK1D,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAUvE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAgC1E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEnE;AAED,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+export declare const StakeBtcbToLbtcSchema: z.ZodObject<{
+    amount: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+}, {
+    amount: string;
+}>;
+export declare const UnstakeLbtcSchema: z.ZodObject<{
+    amount: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    recipient: z.ZodEffects<z.ZodString, string, string>;
+    outputAsset: z.ZodEnum<["BTC", "BTCb"]>;
+}, "strip", z.ZodTypeAny, {
+    recipient: string;
+    amount: string;
+    outputAsset: "BTC" | "BTCb";
+}, {
+    recipient: string;
+    amount: string;
+    outputAsset: "BTC" | "BTCb";
+}>;
+export declare const RedeemLbtcToBtcbSchema: z.ZodObject<{
+    amount: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+}, {
+    amount: string;
+}>;
+export declare const DeployToDefiSchema: z.ZodObject<{
+    amount: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+}, {
+    amount: string;
+}>;
+export declare const ClaimDepositSchema: z.ZodObject<{
+    depositTxHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    depositTxHash: string;
+}, {
+    depositTxHash: string;
+}>;
+export declare const GetLbtcBalanceSchema: z.ZodObject<{
+    address: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    address?: string | undefined;
+}, {
+    address?: string | undefined;
+}>;
+export declare const GetBtcbBalanceSchema: z.ZodObject<{
+    address: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    address?: string | undefined;
+}, {
+    address?: string | undefined;
+}>;
+export declare const GetLbtcExchangeRateSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const GetDepositStatusSchema: z.ZodObject<{
+    address: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    address?: string | undefined;
+}, {
+    address?: string | undefined;
+}>;
+export declare const GetUnstakeStatusSchema: z.ZodObject<{
+    address: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    address?: string | undefined;
+}, {
+    address?: string | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;EAShC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAyB5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;EASjC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;EAO7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;EAM7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAQ/B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAQ/B,CAAC;AAEH,eAAO,MAAM,yBAAyB,gDAAe,CAAC;AAEtD,eAAO,MAAM,sBAAsB;;;;;;EAQjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;EAQjC,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,28 @@
+import type { EvmWalletProvider } from "@coinbase/agentkit";
+import type { ChainId } from "@lombard.finance/sdk";
+import { Token } from "@lombard.finance/sdk";
+import type { Env } from "@lombard.finance/sdk-common";
+import type { Address, EIP1193Provider } from "viem";
+/**
+ * Adapts a Coinbase AgentKit EvmWalletProvider into a viem-compatible
+ * EIP1193Provider that the Lombard SDK contract functions expect.
+ *
+ * The adapter implements the `request` method by delegating to the
+ * appropriate EvmWalletProvider method for each JSON-RPC call.
+ */
+export declare function toEIP1193Provider(walletProvider: EvmWalletProvider, chainId: ChainId): EIP1193Provider;
+/**
+ * Reads an ERC20 token balance using the AgentKit wallet provider's
+ * readContract method directly (avoids needing EIP1193 adapter for reads).
+ */
+export declare function getTokenBalance(walletProvider: EvmWalletProvider, token: Token, chainId: ChainId, address: Address, env?: Env): Promise<{
+    balance: bigint;
+    formatted: string;
+    decimals: number;
+}>;
+/**
+ * Format a result string for AgentKit action responses.
+ */
+export declare function formatSuccess(action: string, details: Record<string, unknown>): string;
+export declare function formatError(action: string, error: unknown): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAIL,KAAK,EACN,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAO,MAAM,MAAM,CAAC;AAG1D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,iBAAiB,EACjC,OAAO,EAAE,OAAO,GACf,eAAe,CAkEjB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,cAAc,EAAE,iBAAiB,EACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,GAAG,GACR,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAER;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAWlE"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@lombard.finance/sdk-agentkit",
+  "version": "0.1.0",
+  "description": "Lombard Action Provider for Coinbase AgentKit - stake BTC, mint LBTC, and interact with DeFi via AI agents",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "license": "MIT",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">= 18.0.0"
+  },
+  "scripts": {
+    "types": "tsc --noEmit",
+    "build": "yarn types && vite build && tsc -p tsconfig.build.json",
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx --max-warnings=0",
+    "format": "prettier --write \"src/**/*.{js,jsx,ts,tsx}\"",
+    "format:check": "prettier --check \"src/**/*.{js,jsx,ts,tsx}\"",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:unit": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lombard-finance/sdk.git",
+    "directory": "packages/sdk-agentkit"
+  },
+  "homepage": "https://docs.lombard.finance",
+  "bugs": {
+    "url": "https://github.com/lombard-finance/sdk/issues"
+  },
+  "keywords": [
+    "lombard",
+    "sdk",
+    "agentkit",
+    "coinbase",
+    "bitcoin",
+    "lbtc",
+    "ai",
+    "agent"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@coinbase/agentkit": ">=0.2.0",
+    "viem": "^2.21.0",
+    "zod": "^3.22.0"
+  },
+  "dependencies": {
+    "@lombard.finance/sdk": "5.0.4",
+    "@lombard.finance/sdk-common": "4.0.0",
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@coinbase/agentkit": "^0.2.0",
+    "@swc/core": "^1.15.18",
+    "typescript": "^5.4.5",
+    "unplugin-swc": "^1.5.9",
+    "viem": "^2.21.0",
+    "vite": "^6.3.5",
+    "vitest": "^3.2.4",
+    "zod": "^3.22.0"
+  }
+}