@waiaas/actions 2.9.0-rc → 2.9.0-rc.2

package/dist/index.d.ts

@@ -30,6 +30,12 @@ export { AAVE_V3_DEFAULTS, AAVE_V3_ADDRESSES, getAaveAddresses, AAVE_CHAIN_ID_MA
 export type { AaveV3Config, AaveChainAddresses } from './providers/aave-v3/config.js';
 export type { IRpcCaller, UserAccountData, ReserveData } from './providers/aave-v3/aave-rpc.js';
 export { decodeGetUserAccountData, decodeGetReserveData, simulateHealthFactor, rayToApy, hfToNumber, LIQUIDATION_THRESHOLD_HF, WARNING_THRESHOLD_HF } from './providers/aave-v3/aave-rpc.js';
+export { KaminoLendingProvider } from './providers/kamino/index.js';
+export { KAMINO_DEFAULTS, KAMINO_PROGRAM_ID, KAMINO_MAIN_MARKET, resolveMarketAddress } from './providers/kamino/config.js';
+export type { KaminoConfig } from './providers/kamino/config.js';
+export type { IKaminoSdkWrapper, KaminoInstruction, KaminoObligation, KaminoReserve } from './providers/kamino/kamino-sdk-wrapper.js';
+export { MockKaminoSdkWrapper } from './providers/kamino/kamino-sdk-wrapper.js';
+export { calculateHealthFactor, simulateKaminoHealthFactor, hfToStatus, KAMINO_LIQUIDATION_THRESHOLD, KAMINO_DEFAULT_HF_THRESHOLD } from './providers/kamino/hf-simulation.js';
 export { ActionApiClient } from './common/action-api-client.js';
 export { asBps, asPct, clampSlippageBps, bpsToPct, pctToBps } from './common/slippage.js';
 export type { SlippageBps, SlippagePct } from './common/slippage.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,cAAc,CAAC;AAWjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAKlE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC/F,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC5I,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEzG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC7I,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACrH,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAE7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACzH,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACtF,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE7L,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAC5H,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACtI,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,UAAU,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAG/K,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,kCAAkC,CAAC;AAM1C,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,EAAE,cAAc,EAC9B,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA0IzC"}

package/dist/index.js

@@ -8,6 +8,7 @@ import { JitoStakingActionProvider } from './providers/jito-staking/index.js';
 import { getJitoAddresses } from './providers/jito-staking/config.js';
 import { AaveV3LendingProvider } from './providers/aave-v3/index.js';
 import {} from './providers/aave-v3/config.js';
+import { KaminoLendingProvider } from './providers/kamino/index.js';
 // Re-export provider classes
 export { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
 export { JUPITER_PROGRAM_ID, JUPITER_SWAP_DEFAULTS } from './providers/jupiter-swap/config.js';
@@ -26,6 +27,10 @@ export { JitoEpochTracker } from './providers/jito-staking/epoch-tracker.js';
 export { AaveV3LendingProvider } from './providers/aave-v3/index.js';
 export { AAVE_V3_DEFAULTS, AAVE_V3_ADDRESSES, getAaveAddresses, AAVE_CHAIN_ID_MAP } from './providers/aave-v3/config.js';
 export { decodeGetUserAccountData, decodeGetReserveData, simulateHealthFactor, rayToApy, hfToNumber, LIQUIDATION_THRESHOLD_HF, WARNING_THRESHOLD_HF } from './providers/aave-v3/aave-rpc.js';
+export { KaminoLendingProvider } from './providers/kamino/index.js';
+export { KAMINO_DEFAULTS, KAMINO_PROGRAM_ID, KAMINO_MAIN_MARKET, resolveMarketAddress } from './providers/kamino/config.js';
+export { MockKaminoSdkWrapper } from './providers/kamino/kamino-sdk-wrapper.js';
+export { calculateHealthFactor, simulateKaminoHealthFactor, hfToStatus, KAMINO_LIQUIDATION_THRESHOLD, KAMINO_DEFAULT_HF_THRESHOLD } from './providers/kamino/hf-simulation.js';
 // Re-export common utilities
 export { ActionApiClient } from './common/action-api-client.js';
 export { asBps, asPct, clampSlippageBps, bpsToPct, pctToBps } from './common/slippage.js';
@@ -132,6 +137,18 @@ export function registerBuiltInProviders(registry, settingsReader, options) {
                 return new AaveV3LendingProvider(config, options?.rpcCaller);
             },
         },
+        {
+            key: 'kamino',
+            enabledKey: 'actions.kamino_enabled',
+            factory: () => {
+                const config = {
+                    enabled: true,
+                    market: settingsReader.get('actions.kamino_market') || 'main',
+                    hfThreshold: Number(settingsReader.get('actions.kamino_hf_threshold')) || 1.2,
+                };
+                return new KaminoLendingProvider(config);
+            },
+        },
     ];
     for (const { key, enabledKey, factory } of providers) {
         if (settingsReader.get(enabledKey) === 'true') {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAA0B,MAAM,oCAAoC,CAAC;AAC9F,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAA0B,MAAM,oCAAoC,CAAC;AAC9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAqB,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,6BAA6B;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG/F,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG5I,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE3F,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEzG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE7I,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAErH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAE7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGzH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE7L,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAG5H,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,UAAU,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAE/K,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG1F,qEAAqE;AACrE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAoB1C;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA0B,EAC1B,cAA8B,EAC9B,OAAoC;IAEpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,SAAS,GAIV;QACH;YACE,GAAG,EAAE,cAAc;YACnB,UAAU,EAAE,8BAA8B;YAC1C,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,MAAM,GAAmE;oBAC7E,OAAO,EAAE,IAAI;oBACb,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,mCAAmC,CAAC;oBACnE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,8BAA8B,CAAC;oBAC1D,kBAAkB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;oBAC3F,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;oBACnF,iBAAiB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;oBAC1F,eAAe,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;oBACrF,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;iBACxF,CAAC;gBACF,OAAO,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;SACF;QACD;YACE,GAAG,EAAE,YAAY;YACjB,UAAU,EAAE,4BAA4B;YACxC,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,MAAM,GAAyE;oBACnF,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,4BAA4B,CAAC;oBACxD,kBAAkB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;oBACzF,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;oBACjF,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;iBACtF,CAAC;gBACF,OAAO,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;SACF;QACD;YACE,GAAG,EAAE,MAAM;YACX,UAAU,EAAE,sBAAsB;YAClC,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,MAAM,GAAoD;oBAC9D,OAAO,EAAE,IAAI;oBACb,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,2BAA2B,CAAC;oBAC3D,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,sBAAsB,CAAC;oBAClD,kBAAkB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;oBACnF,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;oBAC3E,gBAAgB,EAAE,MAAM;iBACzB,CAAC;gBACF,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;SACF;QACD;YACE,GAAG,EAAE,cAAc;YACnB,UAAU,EAAE,8BAA8B;YAC1C,OAAO,EAAE,GAAG,EAAE;gBACZ,sEAAsE;gBACtE,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,kBAAkB,CAAC;gBACvF,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAyB,CAAC,KAAK,SAAS,CAAC;gBAC7E,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBAEtE,gGAAgG;gBAChG,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;gBAC/E,MAAM,kBAAkB,GAAG,cAAc,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;gBAE/F,MAAM,MAAM,GAAsB;oBAChC,OAAO,EAAE,IAAI;oBACb,YAAY,EAAE,aAAa,IAAI,SAAS,CAAC,YAAY;oBACrD,sBAAsB,EAAE,kBAAkB,IAAI,SAAS,CAAC,sBAAsB;iBAC/E,CAAC;gBACF,OAAO,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;SACF;QACD;YACE,GAAG,EAAE,cAAc;YACnB,UAAU,EAAE,8BAA8B;YAC1C,OAAO,EAAE,GAAG,EAAE;gBACZ,kDAAkD;gBAClD,8EAA8E;gBAC9E,MAAM,iBAAiB,GAAG,cAAc,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;gBACxF,MAAM,mBAAmB,GAAG,cAAc,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;gBAEpF,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;gBAE9C,MAAM,MAAM,GAAsB;oBAChC,OAAO,EAAE,IAAI;oBACb,gBAAgB,EAAE,iBAAiB,IAAI,SAAS,CAAC,gBAAgB;oBACjE,WAAW,EAAE,mBAAmB,IAAI,SAAS,CAAC,WAAW;oBACzD,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;iBAC7C,CAAC;gBACF,OAAO,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;SACF;QACD;YACE,GAAG,EAAE,SAAS;YACd,UAAU,EAAE,yBAAyB;YACrC,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,MAAM,GAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBAC/C,OAAO,IAAI,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YAC/D,CAAC;SACF;QACD;YACE,GAAG,EAAE,QAAQ;YACb,UAAU,EAAE,wBAAwB;YACpC,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,MAAM,GAAiB;oBAC3B,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,MAAM;oBAC7D,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,IAAI,GAAG;iBAC9E,CAAC;gBACF,OAAO,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;SACF;KACF,CAAC;IAEF,KAAK,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,SAAS,EAAE,CAAC;QACrD,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAC;gBAC3B,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,sBAAsB,GAAG,wBAAwB,EAAE,GAAG,CAAC,CAAC;gBACrE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/providers/kamino/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Kamino K-Lend configuration type, defaults, and program addresses.
+ *
+ * Supports: Solana mainnet (Kamino K-Lend V2).
+ * Main market address verified from Kamino Finance documentation.
+ */
+export interface KaminoConfig {
+    enabled: boolean;
+    /** Market identifier: 'main' or a custom market pubkey. */
+    market: string;
+    /** Health factor warning threshold. Default 1.2. */
+    hfThreshold: number;
+}
+/** Kamino K-Lend V2 program ID on Solana mainnet. */
+export declare const KAMINO_PROGRAM_ID = "KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD";
+/** Kamino main lending market pubkey (Solana mainnet). */
+export declare const KAMINO_MAIN_MARKET = "7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF";
+export declare const KAMINO_DEFAULTS: KaminoConfig;
+/**
+ * Resolve market identifier to an actual pubkey.
+ *
+ * @param market - 'main' or a custom market pubkey string
+ * @returns The market address string
+ */
+export declare function resolveMarketAddress(market: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/providers/kamino/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/providers/kamino/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,gDAAgD,CAAC;AAE/E,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,iDAAiD,CAAC;AAMjF,eAAO,MAAM,eAAe,EAAE,YAI7B,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/providers/kamino/config.js

@@ -0,0 +1,34 @@
+/**
+ * Kamino K-Lend configuration type, defaults, and program addresses.
+ *
+ * Supports: Solana mainnet (Kamino K-Lend V2).
+ * Main market address verified from Kamino Finance documentation.
+ */
+// ---------------------------------------------------------------------------
+// Program constants
+// ---------------------------------------------------------------------------
+/** Kamino K-Lend V2 program ID on Solana mainnet. */
+export const KAMINO_PROGRAM_ID = 'KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD';
+/** Kamino main lending market pubkey (Solana mainnet). */
+export const KAMINO_MAIN_MARKET = '7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF';
+// ---------------------------------------------------------------------------
+// Defaults (disabled)
+// ---------------------------------------------------------------------------
+export const KAMINO_DEFAULTS = {
+    enabled: false,
+    market: 'main',
+    hfThreshold: 1.2,
+};
+// ---------------------------------------------------------------------------
+// Helper to resolve market address
+// ---------------------------------------------------------------------------
+/**
+ * Resolve market identifier to an actual pubkey.
+ *
+ * @param market - 'main' or a custom market pubkey string
+ * @returns The market address string
+ */
+export function resolveMarketAddress(market) {
+    return market === 'main' ? KAMINO_MAIN_MARKET : market;
+}
+//# sourceMappingURL=config.js.map

package/dist/providers/kamino/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/providers/kamino/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,6CAA6C,CAAC;AAE/E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,8CAA8C,CAAC;AAEjF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,GAAG;CACjB,CAAC;AAEF,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC"}

package/dist/providers/kamino/hf-simulation.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Kamino Health Factor simulation functions.
+ *
+ * Pure functions for calculating and simulating Kamino health factor changes.
+ * Unlike Aave (bigint 18-decimal precision), Kamino SDK provides USD values
+ * as floats, so number arithmetic is used. This is safe because HF threshold
+ * comparisons happen at the 0.01 precision level (e.g., 1.20 vs 1.05).
+ *
+ * Used by KaminoLendingProvider to guard borrow/withdraw actions against
+ * self-liquidation risk (KPROV-08).
+ */
+/** HF at liquidation (1.0). Below this, the position can be liquidated. */
+export declare const KAMINO_LIQUIDATION_THRESHOLD = 1;
+/** Default HF warning threshold (configurable via Admin Settings). */
+export declare const KAMINO_DEFAULT_HF_THRESHOLD = 1.2;
+/**
+ * Calculate health factor from Kamino obligation data.
+ *
+ * HF = (totalCollateralUsd * weightedLiqThreshold) / totalDebtUsd
+ * When totalDebt is 0, returns Infinity.
+ *
+ * @param totalCollateralUsd - Total collateral in USD
+ * @param totalDebtUsd - Total debt in USD
+ * @param weightedLiqThreshold - Weighted liquidation threshold (default 0.85)
+ * @returns Health factor as a number
+ */
+export declare function calculateHealthFactor(totalCollateralUsd: number, totalDebtUsd: number, weightedLiqThreshold?: number): number;
+/**
+ * Simulate health factor after a borrow or withdraw action.
+ *
+ * @param obligation - Current obligation summary (collateral/debt in USD)
+ * @param action - 'borrow' (increases debt) or 'withdraw' (decreases collateral)
+ * @param amountUsd - Amount in USD terms (approximate, for simulation)
+ * @param threshold - HF threshold to check against (default: KAMINO_LIQUIDATION_THRESHOLD)
+ * @returns Simulation result with safe flag, simulated HF, and threshold
+ */
+export declare function simulateKaminoHealthFactor(obligation: {
+    totalCollateralUsd: number;
+    totalDebtUsd: number;
+}, action: 'borrow' | 'withdraw', amountUsd: number, threshold?: number): {
+    safe: boolean;
+    simulatedHf: number;
+    threshold: number;
+};
+/**
+ * Convert a health factor value to a status string.
+ *
+ * @param hf - Health factor value
+ * @returns Status: 'safe' (>= 2.0), 'warning' (>= 1.5), 'danger' (>= 1.2), 'critical' (< 1.2)
+ */
+export declare function hfToStatus(hf: number): 'safe' | 'warning' | 'danger' | 'critical';
+//# sourceMappingURL=hf-simulation.d.ts.map

package/dist/providers/kamino/hf-simulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-simulation.d.ts","sourceRoot":"","sources":["../../../src/providers/kamino/hf-simulation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,2EAA2E;AAC3E,eAAO,MAAM,4BAA4B,IAAM,CAAC;AAEhD,sEAAsE;AACtE,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAM/C;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,MAAM,EACpB,oBAAoB,GAAE,MAAa,GAClC,MAAM,CAGR;AAMD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EAChE,MAAM,EAAE,QAAQ,GAAG,UAAU,EAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAqC,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAgB3D;AAMD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAKjF"}

package/dist/providers/kamino/hf-simulation.js

@@ -0,0 +1,84 @@
+/**
+ * Kamino Health Factor simulation functions.
+ *
+ * Pure functions for calculating and simulating Kamino health factor changes.
+ * Unlike Aave (bigint 18-decimal precision), Kamino SDK provides USD values
+ * as floats, so number arithmetic is used. This is safe because HF threshold
+ * comparisons happen at the 0.01 precision level (e.g., 1.20 vs 1.05).
+ *
+ * Used by KaminoLendingProvider to guard borrow/withdraw actions against
+ * self-liquidation risk (KPROV-08).
+ */
+// ---------------------------------------------------------------------------
+// Threshold constants
+// ---------------------------------------------------------------------------
+/** HF at liquidation (1.0). Below this, the position can be liquidated. */
+export const KAMINO_LIQUIDATION_THRESHOLD = 1.0;
+/** Default HF warning threshold (configurable via Admin Settings). */
+export const KAMINO_DEFAULT_HF_THRESHOLD = 1.2;
+// ---------------------------------------------------------------------------
+// calculateHealthFactor
+// ---------------------------------------------------------------------------
+/**
+ * Calculate health factor from Kamino obligation data.
+ *
+ * HF = (totalCollateralUsd * weightedLiqThreshold) / totalDebtUsd
+ * When totalDebt is 0, returns Infinity.
+ *
+ * @param totalCollateralUsd - Total collateral in USD
+ * @param totalDebtUsd - Total debt in USD
+ * @param weightedLiqThreshold - Weighted liquidation threshold (default 0.85)
+ * @returns Health factor as a number
+ */
+export function calculateHealthFactor(totalCollateralUsd, totalDebtUsd, weightedLiqThreshold = 0.85) {
+    if (totalDebtUsd <= 0)
+        return Infinity;
+    return (totalCollateralUsd * weightedLiqThreshold) / totalDebtUsd;
+}
+// ---------------------------------------------------------------------------
+// simulateKaminoHealthFactor
+// ---------------------------------------------------------------------------
+/**
+ * Simulate health factor after a borrow or withdraw action.
+ *
+ * @param obligation - Current obligation summary (collateral/debt in USD)
+ * @param action - 'borrow' (increases debt) or 'withdraw' (decreases collateral)
+ * @param amountUsd - Amount in USD terms (approximate, for simulation)
+ * @param threshold - HF threshold to check against (default: KAMINO_LIQUIDATION_THRESHOLD)
+ * @returns Simulation result with safe flag, simulated HF, and threshold
+ */
+export function simulateKaminoHealthFactor(obligation, action, amountUsd, threshold = KAMINO_LIQUIDATION_THRESHOLD) {
+    let collateral = obligation.totalCollateralUsd;
+    let debt = obligation.totalDebtUsd;
+    if (action === 'borrow') {
+        debt += amountUsd;
+    }
+    else {
+        collateral -= amountUsd;
+    }
+    const simulatedHf = calculateHealthFactor(collateral, debt);
+    return {
+        safe: simulatedHf >= threshold,
+        simulatedHf,
+        threshold,
+    };
+}
+// ---------------------------------------------------------------------------
+// hfToStatus
+// ---------------------------------------------------------------------------
+/**
+ * Convert a health factor value to a status string.
+ *
+ * @param hf - Health factor value
+ * @returns Status: 'safe' (>= 2.0), 'warning' (>= 1.5), 'danger' (>= 1.2), 'critical' (< 1.2)
+ */
+export function hfToStatus(hf) {
+    if (hf >= 2.0)
+        return 'safe';
+    if (hf >= 1.5)
+        return 'warning';
+    if (hf >= 1.2)
+        return 'danger';
+    return 'critical';
+}
+//# sourceMappingURL=hf-simulation.js.map

package/dist/providers/kamino/hf-simulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-simulation.js","sourceRoot":"","sources":["../../../src/providers/kamino/hf-simulation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,sEAAsE;AACtE,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,kBAA0B,EAC1B,YAAoB,EACpB,uBAA+B,IAAI;IAEnC,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvC,OAAO,CAAC,kBAAkB,GAAG,oBAAoB,CAAC,GAAG,YAAY,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAgE,EAChE,MAA6B,EAC7B,SAAiB,EACjB,YAAoB,4BAA4B;IAEhD,IAAI,UAAU,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAC/C,IAAI,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC;IAEnC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,IAAI,IAAI,SAAS,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,UAAU,IAAI,SAAS,CAAC;IAC1B,CAAC;IAED,MAAM,WAAW,GAAG,qBAAqB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE,WAAW,IAAI,SAAS;QAC9B,WAAW;QACX,SAAS;KACV,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,IAAI,EAAE,IAAI,GAAG;QAAE,OAAO,MAAM,CAAC;IAC7B,IAAI,EAAE,IAAI,GAAG;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,EAAE,IAAI,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC/B,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/providers/kamino/index.d.ts

@@ -0,0 +1,25 @@
+import type { ILendingProvider, ActionProviderMetadata, ActionDefinition, ActionContext, ContractCallRequest, LendingPositionSummary, HealthFactor, MarketInfo } from '@waiaas/core';
+import type { IPositionProvider, PositionUpdate, PositionCategory } from '@waiaas/core';
+import type { KaminoConfig } from './config.js';
+import type { IKaminoSdkWrapper } from './kamino-sdk-wrapper.js';
+export declare class KaminoLendingProvider implements ILendingProvider, IPositionProvider {
+    readonly metadata: ActionProviderMetadata;
+    readonly actions: readonly ActionDefinition[];
+    private readonly config;
+    private readonly sdkWrapper;
+    constructor(config?: Partial<KaminoConfig>, sdkWrapper?: IKaminoSdkWrapper);
+    resolve(actionName: string, params: Record<string, unknown>, context: ActionContext): Promise<ContractCallRequest | ContractCallRequest[]>;
+    private resolveSupply;
+    private resolveBorrow;
+    private resolveRepay;
+    private resolveWithdraw;
+    private checkBorrowSafety;
+    private checkWithdrawSafety;
+    getPosition(_walletId: string, context: ActionContext): Promise<LendingPositionSummary[]>;
+    getHealthFactor(_walletId: string, context: ActionContext): Promise<HealthFactor>;
+    getMarkets(chain: string, _network?: string): Promise<MarketInfo[]>;
+    getPositions(walletId: string): Promise<PositionUpdate[]>;
+    getProviderName(): string;
+    getSupportedCategories(): PositionCategory[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/kamino/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/kamino/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,yBAAyB,CAAC;AAoEpF,qBAAa,qBAAsB,YAAW,gBAAgB,EAAE,iBAAiB;IAC/E,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,EAAE,iBAAiB;IAsDpE,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;YAqBzC,aAAa;YAsBb,aAAa;YA2Bb,YAAY;YAsBZ,eAAe;YA4Bf,iBAAiB;YA+BjB,mBAAmB;IAiC3B,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAqCzF,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBjF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAwBnE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAkD/D,eAAe,IAAI,MAAM;IAIzB,sBAAsB,IAAI,gBAAgB,EAAE;CAG7C"}

package/dist/providers/kamino/index.js

@@ -0,0 +1,381 @@
+/**
+ * Kamino K-Lend Lending Action Provider.
+ *
+ * Implements ILendingProvider + IPositionProvider to resolve Kamino
+ * lending requests into ContractCallRequest arrays for the sequential pipeline.
+ *
+ * Actions:
+ * - kamino_supply: supply token as collateral (medium risk, DELAY)
+ * - kamino_borrow: borrow against collateral (high risk, APPROVAL)
+ * - kamino_repay: repay borrowed debt (medium risk, DELAY, supports 'max')
+ * - kamino_withdraw: withdraw collateral (high risk, APPROVAL, supports 'max')
+ *
+ * Uses IKaminoSdkWrapper for instruction building and obligation queries.
+ * MockKaminoSdkWrapper enables unit testing without real SDK/RPC.
+ */
+import { ChainError } from '@waiaas/core';
+import { KAMINO_DEFAULTS, resolveMarketAddress } from './config.js';
+import { MockKaminoSdkWrapper } from './kamino-sdk-wrapper.js';
+import { KaminoSupplyInputSchema, KaminoBorrowInputSchema, KaminoRepayInputSchema, KaminoWithdrawInputSchema, } from './schemas.js';
+import { simulateKaminoHealthFactor, calculateHealthFactor, hfToStatus, KAMINO_LIQUIDATION_THRESHOLD, } from './hf-simulation.js';
+// ---------------------------------------------------------------------------
+// Amount parsing helper
+// ---------------------------------------------------------------------------
+/**
+ * Parse a human-readable token amount string to smallest unit (bigint).
+ * SPL tokens typically use 6 decimals (USDC), 9 (SOL), or other values.
+ *
+ * @param amount - Human-readable amount string (e.g., "100.5")
+ * @param decimals - Token decimals (default 6 for most SPL stablecoins)
+ * @throws ChainError if amount is zero or negative
+ */
+function parseTokenAmount(amount, decimals = 6) {
+    const parts = amount.split('.');
+    const whole = BigInt(parts[0] || '0');
+    const fractional = (parts[1] || '').padEnd(decimals, '0').slice(0, decimals);
+    const result = whole * 10n ** BigInt(decimals) + BigInt(fractional);
+    if (result <= 0n) {
+        throw new ChainError('INVALID_INSTRUCTION', 'solana', {
+            message: 'Amount must be greater than 0',
+        });
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Instruction-to-request conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert KaminoInstruction[] to ContractCallRequest[].
+ * Each instruction becomes a ContractCallRequest with Solana fields.
+ */
+function instructionsToRequests(instructions, marketAddress) {
+    return instructions.map((ix) => ({
+        type: 'CONTRACT_CALL',
+        to: marketAddress,
+        programId: ix.programId,
+        instructionData: ix.instructionData,
+        accounts: ix.accounts,
+        network: 'mainnet',
+    }));
+}
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+export class KaminoLendingProvider {
+    metadata;
+    actions;
+    config;
+    sdkWrapper;
+    constructor(config, sdkWrapper) {
+        this.config = { ...KAMINO_DEFAULTS, ...config };
+        this.sdkWrapper = sdkWrapper ?? new MockKaminoSdkWrapper();
+        this.metadata = {
+            name: 'kamino',
+            description: 'Kamino K-Lend DeFi lending protocol for Solana: supply, borrow, repay, withdraw',
+            version: '1.0.0',
+            chains: ['solana'],
+            mcpExpose: true,
+            requiresApiKey: false,
+            requiredApis: [],
+        };
+        this.actions = [
+            {
+                name: 'kamino_supply',
+                description: 'Supply (deposit) an SPL token as collateral to Kamino K-Lend lending market',
+                chain: 'solana',
+                inputSchema: KaminoSupplyInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+            {
+                name: 'kamino_borrow',
+                description: 'Borrow an asset from Kamino K-Lend against deposited collateral on Solana',
+                chain: 'solana',
+                inputSchema: KaminoBorrowInputSchema,
+                riskLevel: 'high',
+                defaultTier: 'APPROVAL',
+            },
+            {
+                name: 'kamino_repay',
+                description: 'Repay borrowed debt on Kamino K-Lend. Use amount="max" for full repayment.',
+                chain: 'solana',
+                inputSchema: KaminoRepayInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+            {
+                name: 'kamino_withdraw',
+                description: 'Withdraw supplied collateral from Kamino K-Lend. Use amount="max" for full withdrawal.',
+                chain: 'solana',
+                inputSchema: KaminoWithdrawInputSchema,
+                riskLevel: 'high',
+                defaultTier: 'APPROVAL',
+            },
+        ];
+    }
+    // -------------------------------------------------------------------------
+    // IActionProvider.resolve()
+    // -------------------------------------------------------------------------
+    async resolve(actionName, params, context) {
+        switch (actionName) {
+            case 'kamino_supply':
+                return this.resolveSupply(params, context);
+            case 'kamino_borrow':
+                return this.resolveBorrow(params, context);
+            case 'kamino_repay':
+                return this.resolveRepay(params, context);
+            case 'kamino_withdraw':
+                return this.resolveWithdraw(params, context);
+            default:
+                throw new ChainError('INVALID_INSTRUCTION', 'solana', {
+                    message: `Unknown action: ${actionName}`,
+                });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Supply: build supply instruction via SDK wrapper
+    // -------------------------------------------------------------------------
+    async resolveSupply(params, context) {
+        const input = KaminoSupplyInputSchema.parse(params);
+        const marketAddress = resolveMarketAddress(input.market ?? this.config.market);
+        const amount = parseTokenAmount(input.amount);
+        const instructions = await this.sdkWrapper.buildSupplyInstruction({
+            market: marketAddress,
+            asset: input.asset,
+            amount,
+            walletAddress: context.walletAddress,
+        });
+        return instructionsToRequests(instructions, marketAddress);
+    }
+    // -------------------------------------------------------------------------
+    // Borrow: HF check + build borrow instruction
+    // -------------------------------------------------------------------------
+    async resolveBorrow(params, context) {
+        const input = KaminoBorrowInputSchema.parse(params);
+        const marketAddress = resolveMarketAddress(input.market ?? this.config.market);
+        const amount = parseTokenAmount(input.amount);
+        // HF simulation: approximate USD value using raw amount
+        // (conservative estimate -- proper conversion requires price oracle)
+        const approximateUsdValue = Number(amount) / 1e6;
+        await this.checkBorrowSafety(context.walletAddress, approximateUsdValue, marketAddress);
+        const instructions = await this.sdkWrapper.buildBorrowInstruction({
+            market: marketAddress,
+            asset: input.asset,
+            amount,
+            walletAddress: context.walletAddress,
+        });
+        return instructionsToRequests(instructions, marketAddress);
+    }
+    // -------------------------------------------------------------------------
+    // Repay: supports 'max' for full repayment
+    // -------------------------------------------------------------------------
+    async resolveRepay(params, context) {
+        const input = KaminoRepayInputSchema.parse(params);
+        const marketAddress = resolveMarketAddress(input.market ?? this.config.market);
+        const amount = input.amount === 'max' ? 'max' : parseTokenAmount(input.amount);
+        const instructions = await this.sdkWrapper.buildRepayInstruction({
+            market: marketAddress,
+            asset: input.asset,
+            amount,
+            walletAddress: context.walletAddress,
+        });
+        return instructionsToRequests(instructions, marketAddress);
+    }
+    // -------------------------------------------------------------------------
+    // Withdraw: supports 'max', HF check for non-max
+    // -------------------------------------------------------------------------
+    async resolveWithdraw(params, context) {
+        const input = KaminoWithdrawInputSchema.parse(params);
+        const marketAddress = resolveMarketAddress(input.market ?? this.config.market);
+        const amount = input.amount === 'max' ? 'max' : parseTokenAmount(input.amount);
+        // Skip HF simulation for 'max' withdrawals (closing position entirely)
+        if (amount !== 'max') {
+            const approximateUsdValue = Number(amount) / 1e6;
+            await this.checkWithdrawSafety(context.walletAddress, approximateUsdValue, marketAddress);
+        }
+        const instructions = await this.sdkWrapper.buildWithdrawInstruction({
+            market: marketAddress,
+            asset: input.asset,
+            amount,
+            walletAddress: context.walletAddress,
+        });
+        return instructionsToRequests(instructions, marketAddress);
+    }
+    // -------------------------------------------------------------------------
+    // HF Safety checks (KPROV-08)
+    // -------------------------------------------------------------------------
+    async checkBorrowSafety(walletAddress, amountUsd, market) {
+        try {
+            const obligation = await this.sdkWrapper.getObligation({ market, walletAddress });
+            if (!obligation)
+                return; // No existing position, skip check
+            const totalCollateralUsd = obligation.deposits.reduce((sum, d) => sum + d.marketValueUsd, 0);
+            const totalDebtUsd = obligation.borrows.reduce((sum, b) => sum + b.marketValueUsd, 0);
+            const result = simulateKaminoHealthFactor({ totalCollateralUsd, totalDebtUsd }, 'borrow', amountUsd, KAMINO_LIQUIDATION_THRESHOLD);
+            if (!result.safe) {
+                throw new ChainError('CONTRACT_EXECUTION_FAILED', 'solana', {
+                    message: `Borrow would cause health factor to drop below liquidation threshold (simulated HF: ${result.simulatedHf.toFixed(4)})`,
+                });
+            }
+        }
+        catch (err) {
+            // Re-throw ChainError, swallow SDK failures (graceful degradation)
+            if (err instanceof ChainError)
+                throw err;
+            // SDK not available or RPC failed -- skip simulation
+        }
+    }
+    async checkWithdrawSafety(walletAddress, amountUsd, market) {
+        try {
+            const obligation = await this.sdkWrapper.getObligation({ market, walletAddress });
+            if (!obligation)
+                return;
+            const totalCollateralUsd = obligation.deposits.reduce((sum, d) => sum + d.marketValueUsd, 0);
+            const totalDebtUsd = obligation.borrows.reduce((sum, b) => sum + b.marketValueUsd, 0);
+            const result = simulateKaminoHealthFactor({ totalCollateralUsd, totalDebtUsd }, 'withdraw', amountUsd, KAMINO_LIQUIDATION_THRESHOLD);
+            if (!result.safe) {
+                throw new ChainError('CONTRACT_EXECUTION_FAILED', 'solana', {
+                    message: `Withdrawal would cause health factor to drop below liquidation threshold (simulated HF: ${result.simulatedHf.toFixed(4)})`,
+                });
+            }
+        }
+        catch (err) {
+            if (err instanceof ChainError)
+                throw err;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // ILendingProvider query methods
+    // -------------------------------------------------------------------------
+    async getPosition(_walletId, context) {
+        try {
+            const marketAddress = resolveMarketAddress(this.config.market);
+            const obligation = await this.sdkWrapper.getObligation({
+                market: marketAddress,
+                walletAddress: context.walletAddress,
+            });
+            if (!obligation)
+                return [];
+            const positions = [];
+            for (const deposit of obligation.deposits) {
+                positions.push({
+                    asset: deposit.mintAddress,
+                    positionType: 'SUPPLY',
+                    amount: deposit.amount.toString(),
+                    amountUsd: deposit.marketValueUsd,
+                    apy: null,
+                });
+            }
+            for (const borrow of obligation.borrows) {
+                positions.push({
+                    asset: borrow.mintAddress,
+                    positionType: 'BORROW',
+                    amount: borrow.amount.toString(),
+                    amountUsd: borrow.marketValueUsd,
+                    apy: null,
+                });
+            }
+            return positions;
+        }
+        catch {
+            return [];
+        }
+    }
+    async getHealthFactor(_walletId, context) {
+        try {
+            const marketAddress = resolveMarketAddress(this.config.market);
+            const obligation = await this.sdkWrapper.getObligation({
+                market: marketAddress,
+                walletAddress: context.walletAddress,
+            });
+            if (!obligation) {
+                return { factor: Infinity, totalCollateralUsd: 0, totalDebtUsd: 0, currentLtv: 0, status: 'safe' };
+            }
+            const totalCollateralUsd = obligation.deposits.reduce((sum, d) => sum + d.marketValueUsd, 0);
+            const totalDebtUsd = obligation.borrows.reduce((sum, b) => sum + b.marketValueUsd, 0);
+            const factor = calculateHealthFactor(totalCollateralUsd, totalDebtUsd);
+            const currentLtv = obligation.loanToValue;
+            const status = hfToStatus(factor);
+            return { factor, totalCollateralUsd, totalDebtUsd, currentLtv, status };
+        }
+        catch {
+            return { factor: Infinity, totalCollateralUsd: 0, totalDebtUsd: 0, currentLtv: 0, status: 'safe' };
+        }
+    }
+    async getMarkets(chain, _network) {
+        if (chain !== 'solana')
+            return [];
+        try {
+            const marketAddress = resolveMarketAddress(this.config.market);
+            const reserves = await this.sdkWrapper.getReserves(marketAddress);
+            return reserves.map((r) => ({
+                asset: r.mintAddress,
+                symbol: r.symbol,
+                supplyApy: r.supplyApy,
+                borrowApy: r.borrowApy,
+                ltv: r.ltvPct / 100,
+                availableLiquidity: r.availableLiquidity,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    // -------------------------------------------------------------------------
+    // IPositionProvider methods
+    // -------------------------------------------------------------------------
+    async getPositions(walletId) {
+        try {
+            const marketAddress = resolveMarketAddress(this.config.market);
+            const obligation = await this.sdkWrapper.getObligation({
+                market: marketAddress,
+                walletAddress: walletId,
+            });
+            if (!obligation)
+                return [];
+            const now = Math.floor(Date.now() / 1000);
+            const updates = [];
+            for (const deposit of obligation.deposits) {
+                updates.push({
+                    walletId,
+                    category: 'LENDING',
+                    provider: 'kamino',
+                    chain: 'solana',
+                    network: 'mainnet',
+                    assetId: deposit.mintAddress,
+                    amount: deposit.amount.toString(),
+                    amountUsd: deposit.marketValueUsd,
+                    metadata: { positionType: 'SUPPLY', market: marketAddress },
+                    status: 'ACTIVE',
+                    openedAt: now,
+                });
+            }
+            for (const borrow of obligation.borrows) {
+                updates.push({
+                    walletId,
+                    category: 'LENDING',
+                    provider: 'kamino',
+                    chain: 'solana',
+                    network: 'mainnet',
+                    assetId: borrow.mintAddress,
+                    amount: borrow.amount.toString(),
+                    amountUsd: borrow.marketValueUsd,
+                    metadata: { positionType: 'BORROW', market: marketAddress },
+                    status: 'ACTIVE',
+                    openedAt: now,
+                });
+            }
+            return updates;
+        }
+        catch {
+            return [];
+        }
+    }
+    getProviderName() {
+        return 'kamino';
+    }
+    getSupportedCategories() {
+        return ['LENDING'];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/kamino/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/kamino/index.ts"],"names":[],"mappings":"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"}

package/dist/providers/kamino/kamino-sdk-wrapper.d.ts

@@ -0,0 +1,149 @@
+/** Kamino instruction result (converted from TransactionInstruction). */
+export interface KaminoInstruction {
+    programId: string;
+    /** Base64-encoded instruction data. */
+    instructionData: string;
+    accounts: Array<{
+        pubkey: string;
+        isSigner: boolean;
+        isWritable: boolean;
+    }>;
+}
+export interface KaminoObligation {
+    deposits: Array<{
+        mintAddress: string;
+        amount: bigint;
+        marketValueUsd: number;
+    }>;
+    borrows: Array<{
+        mintAddress: string;
+        amount: bigint;
+        marketValueUsd: number;
+    }>;
+    /** Pre-calculated by SDK from obligation account data. */
+    loanToValue: number;
+}
+export interface KaminoReserve {
+    mintAddress: string;
+    symbol: string;
+    supplyApy: number;
+    borrowApy: number;
+    ltvPct: number;
+    availableLiquidity: string;
+}
+/** Abstraction over @kamino-finance/klend-sdk for testability. */
+export interface IKaminoSdkWrapper {
+    buildSupplyInstruction(params: {
+        market: string;
+        asset: string;
+        amount: bigint;
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildBorrowInstruction(params: {
+        market: string;
+        asset: string;
+        amount: bigint;
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildRepayInstruction(params: {
+        market: string;
+        asset: string;
+        amount: bigint | 'max';
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildWithdrawInstruction(params: {
+        market: string;
+        asset: string;
+        amount: bigint | 'max';
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    /** Get obligation (position) data for a wallet. */
+    getObligation(params: {
+        market: string;
+        walletAddress: string;
+    }): Promise<KaminoObligation | null>;
+    /** Get reserve data for market data queries. */
+    getReserves(market: string): Promise<KaminoReserve[]>;
+}
+/**
+ * MockKaminoSdkWrapper: deterministic mock data for testing.
+ *
+ * Builds structurally valid KaminoInstruction arrays with recognizable
+ * mock instruction data (action index prefix + amount as LE u64).
+ */
+export declare class MockKaminoSdkWrapper implements IKaminoSdkWrapper {
+    buildSupplyInstruction(params: {
+        market: string;
+        asset: string;
+        amount: bigint;
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildBorrowInstruction(params: {
+        market: string;
+        asset: string;
+        amount: bigint;
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildRepayInstruction(params: {
+        market: string;
+        asset: string;
+        amount: bigint | 'max';
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildWithdrawInstruction(params: {
+        market: string;
+        asset: string;
+        amount: bigint | 'max';
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    getObligation(_params: {
+        market: string;
+        walletAddress: string;
+    }): Promise<KaminoObligation | null>;
+    getReserves(_market: string): Promise<KaminoReserve[]>;
+}
+/**
+ * KaminoSdkWrapper: wraps @kamino-finance/klend-sdk.
+ *
+ * Lazily imports the SDK at first use. If the SDK is not installed,
+ * all methods throw ChainError('PROVIDER_NOT_CONFIGURED', 'solana').
+ *
+ * The real implementation converts TransactionInstruction results
+ * to KaminoInstruction format (programId + base64 + accounts).
+ */
+export declare class KaminoSdkWrapper implements IKaminoSdkWrapper {
+    /** RPC URL for future SDK connection. Stored for when klend-sdk is installed. */
+    readonly rpcUrl: string;
+    constructor(rpcUrl: string);
+    private throwNotConfigured;
+    buildSupplyInstruction(_params: {
+        market: string;
+        asset: string;
+        amount: bigint;
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildBorrowInstruction(_params: {
+        market: string;
+        asset: string;
+        amount: bigint;
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildRepayInstruction(_params: {
+        market: string;
+        asset: string;
+        amount: bigint | 'max';
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    buildWithdrawInstruction(_params: {
+        market: string;
+        asset: string;
+        amount: bigint | 'max';
+        walletAddress: string;
+    }): Promise<KaminoInstruction[]>;
+    getObligation(_params: {
+        market: string;
+        walletAddress: string;
+    }): Promise<KaminoObligation | null>;
+    getReserves(_market: string): Promise<KaminoReserve[]>;
+}
+//# sourceMappingURL=kamino-sdk-wrapper.d.ts.map

package/dist/providers/kamino/kamino-sdk-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kamino-sdk-wrapper.d.ts","sourceRoot":"","sources":["../../../src/providers/kamino/kamino-sdk-wrapper.ts"],"names":[],"mappings":"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"}

package/dist/providers/kamino/kamino-sdk-wrapper.js

@@ -0,0 +1,183 @@
+/**
+ * Kamino K-Lend SDK wrapper abstraction.
+ *
+ * IKaminoSdkWrapper provides a testable interface for @kamino-finance/klend-sdk
+ * instruction building. MockKaminoSdkWrapper provides deterministic test data.
+ * KaminoSdkWrapper wraps the real SDK with lazy imports and graceful fallback.
+ *
+ * Instruction results (KaminoInstruction) use the same format as Jito's
+ * ContractCallRequest: programId + base64 instructionData + accounts array.
+ */
+import { KAMINO_PROGRAM_ID } from './config.js';
+// ---------------------------------------------------------------------------
+// Mock instruction data encoding
+// ---------------------------------------------------------------------------
+/**
+ * Encode mock instruction data: 1-byte action index + 8-byte LE u64 amount.
+ * NOT real Kamino CPI layout -- only for unit testing.
+ */
+function encodeMockInstructionData(actionIndex, amount) {
+    const buffer = new Uint8Array(9);
+    buffer[0] = actionIndex;
+    const view = new DataView(buffer.buffer);
+    view.setBigUint64(1, amount, true);
+    return Buffer.from(buffer).toString('base64');
+}
+/** u64 max value for 'max' amounts. */
+const U64_MAX = BigInt('0xFFFFFFFFFFFFFFFF');
+// ---------------------------------------------------------------------------
+// Mock SDK wrapper (for unit testing)
+// ---------------------------------------------------------------------------
+/**
+ * MockKaminoSdkWrapper: deterministic mock data for testing.
+ *
+ * Builds structurally valid KaminoInstruction arrays with recognizable
+ * mock instruction data (action index prefix + amount as LE u64).
+ */
+export class MockKaminoSdkWrapper {
+    async buildSupplyInstruction(params) {
+        return [
+            {
+                programId: KAMINO_PROGRAM_ID,
+                instructionData: encodeMockInstructionData(0, params.amount),
+                accounts: [
+                    { pubkey: params.walletAddress, isSigner: true, isWritable: true },
+                    { pubkey: params.market, isSigner: false, isWritable: true },
+                    { pubkey: params.asset, isSigner: false, isWritable: true },
+                ],
+            },
+        ];
+    }
+    async buildBorrowInstruction(params) {
+        return [
+            {
+                programId: KAMINO_PROGRAM_ID,
+                instructionData: encodeMockInstructionData(1, params.amount),
+                accounts: [
+                    { pubkey: params.walletAddress, isSigner: true, isWritable: true },
+                    { pubkey: params.market, isSigner: false, isWritable: true },
+                    { pubkey: params.asset, isSigner: false, isWritable: false },
+                ],
+            },
+        ];
+    }
+    async buildRepayInstruction(params) {
+        const resolvedAmount = params.amount === 'max' ? U64_MAX : params.amount;
+        return [
+            {
+                programId: KAMINO_PROGRAM_ID,
+                instructionData: encodeMockInstructionData(2, resolvedAmount),
+                accounts: [
+                    { pubkey: params.walletAddress, isSigner: true, isWritable: true },
+                    { pubkey: params.market, isSigner: false, isWritable: true },
+                    { pubkey: params.asset, isSigner: false, isWritable: true },
+                ],
+            },
+        ];
+    }
+    async buildWithdrawInstruction(params) {
+        const resolvedAmount = params.amount === 'max' ? U64_MAX : params.amount;
+        return [
+            {
+                programId: KAMINO_PROGRAM_ID,
+                instructionData: encodeMockInstructionData(3, resolvedAmount),
+                accounts: [
+                    { pubkey: params.walletAddress, isSigner: true, isWritable: true },
+                    { pubkey: params.market, isSigner: false, isWritable: true },
+                    { pubkey: params.asset, isSigner: false, isWritable: true },
+                ],
+            },
+        ];
+    }
+    async getObligation(_params) {
+        return {
+            deposits: [
+                {
+                    mintAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+                    amount: 10000000000n, // 10,000 USDC (6 decimals)
+                    marketValueUsd: 10_000,
+                },
+            ],
+            borrows: [
+                {
+                    mintAddress: 'So11111111111111111111111111111111111111112',
+                    amount: 50000000000n, // 50 SOL (9 decimals)
+                    marketValueUsd: 5_000,
+                },
+            ],
+            loanToValue: 0.5,
+        };
+    }
+    async getReserves(_market) {
+        return [
+            {
+                mintAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+                symbol: 'USDC',
+                supplyApy: 0.045,
+                borrowApy: 0.062,
+                ltvPct: 85,
+                availableLiquidity: '5000000000000',
+            },
+            {
+                mintAddress: 'So11111111111111111111111111111111111111112',
+                symbol: 'SOL',
+                supplyApy: 0.032,
+                borrowApy: 0.055,
+                ltvPct: 75,
+                availableLiquidity: '200000000000000',
+            },
+            {
+                mintAddress: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+                symbol: 'USDT',
+                supplyApy: 0.042,
+                borrowApy: 0.059,
+                ltvPct: 80,
+                availableLiquidity: '3000000000000',
+            },
+        ];
+    }
+}
+// ---------------------------------------------------------------------------
+// Real SDK wrapper (lazy import, graceful fallback)
+// ---------------------------------------------------------------------------
+/**
+ * KaminoSdkWrapper: wraps @kamino-finance/klend-sdk.
+ *
+ * Lazily imports the SDK at first use. If the SDK is not installed,
+ * all methods throw ChainError('PROVIDER_NOT_CONFIGURED', 'solana').
+ *
+ * The real implementation converts TransactionInstruction results
+ * to KaminoInstruction format (programId + base64 + accounts).
+ */
+export class KaminoSdkWrapper {
+    /** RPC URL for future SDK connection. Stored for when klend-sdk is installed. */
+    rpcUrl;
+    constructor(rpcUrl) {
+        this.rpcUrl = rpcUrl;
+    }
+    async throwNotConfigured() {
+        const { ChainError } = await import('@waiaas/core');
+        throw new ChainError('INVALID_INSTRUCTION', 'solana', {
+            message: 'Kamino K-Lend SDK not available. Install @kamino-finance/klend-sdk and @solana/web3.js as dependencies.',
+        });
+    }
+    async buildSupplyInstruction(_params) {
+        return this.throwNotConfigured();
+    }
+    async buildBorrowInstruction(_params) {
+        return this.throwNotConfigured();
+    }
+    async buildRepayInstruction(_params) {
+        return this.throwNotConfigured();
+    }
+    async buildWithdrawInstruction(_params) {
+        return this.throwNotConfigured();
+    }
+    async getObligation(_params) {
+        return this.throwNotConfigured();
+    }
+    async getReserves(_market) {
+        return this.throwNotConfigured();
+    }
+}
+//# sourceMappingURL=kamino-sdk-wrapper.js.map

package/dist/providers/kamino/kamino-sdk-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kamino-sdk-wrapper.js","sourceRoot":"","sources":["../../../src/providers/kamino/kamino-sdk-wrapper.ts"],"names":[],"mappings":"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"}

package/dist/providers/kamino/schemas.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Zod SSoT input schemas for Kamino K-Lend lending actions.
+ *
+ * Four schemas for the 4 lending actions: supply, borrow, repay, withdraw.
+ * Amount is always a human-readable string (e.g., "100.5").
+ * Repay and withdraw accept 'max' for full repayment/withdrawal.
+ */
+import { z } from 'zod';
+export declare const KaminoSupplyInputSchema: z.ZodObject<{
+    /** SPL token mint address to supply as collateral. */
+    asset: z.ZodString;
+    /** Amount to supply (human-readable, e.g., "100.5"). */
+    amount: z.ZodString;
+    /** Market pubkey (defaults to config market). */
+    market: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    asset: string;
+    market?: string | undefined;
+}, {
+    amount: string;
+    asset: string;
+    market?: string | undefined;
+}>;
+export declare const KaminoBorrowInputSchema: z.ZodObject<{
+    /** SPL token mint address to borrow. */
+    asset: z.ZodString;
+    /** Amount to borrow (human-readable, e.g., "100.5"). */
+    amount: z.ZodString;
+    /** Market pubkey (defaults to config market). */
+    market: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    asset: string;
+    market?: string | undefined;
+}, {
+    amount: string;
+    asset: string;
+    market?: string | undefined;
+}>;
+export declare const KaminoRepayInputSchema: z.ZodObject<{
+    /** SPL token mint address to repay. */
+    asset: z.ZodString;
+    /** Amount to repay (human-readable, e.g., "100.5") or 'max' for full repayment. */
+    amount: z.ZodUnion<[z.ZodString, z.ZodLiteral<"max">]>;
+    /** Market pubkey (defaults to config market). */
+    market: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    asset: string;
+    market?: string | undefined;
+}, {
+    amount: string;
+    asset: string;
+    market?: string | undefined;
+}>;
+export declare const KaminoWithdrawInputSchema: z.ZodObject<{
+    /** SPL token mint address to withdraw. */
+    asset: z.ZodString;
+    /** Amount to withdraw (human-readable, e.g., "100.5") or 'max' for full withdrawal. */
+    amount: z.ZodUnion<[z.ZodString, z.ZodLiteral<"max">]>;
+    /** Market pubkey (defaults to config market). */
+    market: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    asset: string;
+    market?: string | undefined;
+}, {
+    amount: string;
+    asset: string;
+    market?: string | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/providers/kamino/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/providers/kamino/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB;IAClC,sDAAsD;;IAEtD,wDAAwD;;IAExD,iDAAiD;;;;;;;;;;EAEjD,CAAC;AAMH,eAAO,MAAM,uBAAuB;IAClC,wCAAwC;;IAExC,wDAAwD;;IAExD,iDAAiD;;;;;;;;;;EAEjD,CAAC;AAMH,eAAO,MAAM,sBAAsB;IACjC,uCAAuC;;IAEvC,mFAAmF;;IAEnF,iDAAiD;;;;;;;;;;EAEjD,CAAC;AAMH,eAAO,MAAM,yBAAyB;IACpC,0CAA0C;;IAE1C,uFAAuF;;IAEvF,iDAAiD;;;;;;;;;;EAEjD,CAAC"}

package/dist/providers/kamino/schemas.js

@@ -0,0 +1,53 @@
+/**
+ * Zod SSoT input schemas for Kamino K-Lend lending actions.
+ *
+ * Four schemas for the 4 lending actions: supply, borrow, repay, withdraw.
+ * Amount is always a human-readable string (e.g., "100.5").
+ * Repay and withdraw accept 'max' for full repayment/withdrawal.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Supply input schema
+// ---------------------------------------------------------------------------
+export const KaminoSupplyInputSchema = z.object({
+    /** SPL token mint address to supply as collateral. */
+    asset: z.string().min(1, 'token mint address is required'),
+    /** Amount to supply (human-readable, e.g., "100.5"). */
+    amount: z.string().min(1, 'amount is required (e.g. "100.5")'),
+    /** Market pubkey (defaults to config market). */
+    market: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Borrow input schema
+// ---------------------------------------------------------------------------
+export const KaminoBorrowInputSchema = z.object({
+    /** SPL token mint address to borrow. */
+    asset: z.string().min(1, 'token mint address is required'),
+    /** Amount to borrow (human-readable, e.g., "100.5"). */
+    amount: z.string().min(1, 'amount is required (e.g. "100.5")'),
+    /** Market pubkey (defaults to config market). */
+    market: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Repay input schema (supports 'max' for full repayment)
+// ---------------------------------------------------------------------------
+export const KaminoRepayInputSchema = z.object({
+    /** SPL token mint address to repay. */
+    asset: z.string().min(1, 'token mint address is required'),
+    /** Amount to repay (human-readable, e.g., "100.5") or 'max' for full repayment. */
+    amount: z.string().min(1, 'amount is required').or(z.literal('max')),
+    /** Market pubkey (defaults to config market). */
+    market: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Withdraw input schema (supports 'max' for full withdrawal)
+// ---------------------------------------------------------------------------
+export const KaminoWithdrawInputSchema = z.object({
+    /** SPL token mint address to withdraw. */
+    asset: z.string().min(1, 'token mint address is required'),
+    /** Amount to withdraw (human-readable, e.g., "100.5") or 'max' for full withdrawal. */
+    amount: z.string().min(1, 'amount is required').or(z.literal('max')),
+    /** Market pubkey (defaults to config market). */
+    market: z.string().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/providers/kamino/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/providers/kamino/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,sDAAsD;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC1D,wDAAwD;IACxD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IAC9D,iDAAiD;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,wCAAwC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC1D,wDAAwD;IACxD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IAC9D,iDAAiD;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,uCAAuC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC1D,mFAAmF;IACnF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpE,iDAAiD;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,0CAA0C;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC1D,uFAAuF;IACvF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpE,iDAAiD;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waiaas/actions",
-  "version": "2.9.0-rc",
+  "version": "2.9.0-rc.2",
   "description": "WAIaaS built-in DeFi Action Provider implementations",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,7 @@
   ],
   "dependencies": {
     "zod": "^3.24.0",
-    "@waiaas/core": "2.9.0-rc"
+    "@waiaas/core": "2.9.0-rc.2"
   },
   "devDependencies": {
     "@types/node": "^25.2.3",