@t2000/sdk 0.16.2 → 0.16.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 t2000
+
+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

@@ -71,6 +71,22 @@ await agent.investUnearn({ asset: 'SUI' });
 
 // Sell position (auto-withdraws if earning first)
 await agent.investSell({ asset: 'SUI', usdAmount: 'all' });
+
+// Buy into a strategy (single atomic PTB)
+await agent.investStrategy({ strategy: 'bluechip', usdAmount: 200 });
+
+// Check strategy status
+const status = await agent.getStrategyStatus({ strategy: 'bluechip' });
+console.log(`Total value: $${status.totalValue}`);
+
+// Rebalance strategy to target weights
+await agent.rebalanceStrategy({ strategy: 'bluechip' });
+
+// Set up dollar-cost averaging
+await agent.setupAutoInvest({ amount: 50, frequency: 'weekly', strategy: 'bluechip' });
+
+// Run pending DCA purchases
+await agent.runAutoInvest();
 ```
 
 ## API Reference
@@ -179,7 +195,28 @@ const agent = T2000.fromPrivateKey('suiprivkey1q...');
 | `agent.investSell({ asset, usdAmount \| 'all', maxSlippage? })` | Sell crypto back to USDC (auto-withdraws if earning) | `InvestResult` |
 | `agent.investEarn({ asset })` | Deposit invested asset into best-rate lending for yield | `InvestEarnResult` |
 | `agent.investUnearn({ asset })` | Withdraw from lending, keep in portfolio | `InvestUnearnResult` |
-| `agent.getPortfolio()` | Investment positions + P&L | `PortfolioResult` |
+| `agent.getPortfolio()` | Investment positions + P&L (grouped by strategy) | `PortfolioResult` |
+
+### Strategy Methods
+
+| Method | Description | Returns |
+|--------|-------------|---------|
+| `agent.investStrategy({ strategy, usdAmount, maxSlippage?, dryRun? })` | Buy into a strategy (single atomic PTB) | `StrategyBuyResult` |
+| `agent.sellStrategy({ strategy, maxSlippage? })` | Sell all positions in a strategy | `StrategySellResult` |
+| `agent.rebalanceStrategy({ strategy, maxSlippage?, driftThreshold? })` | Rebalance to target weights | `StrategyRebalanceResult` |
+| `agent.getStrategyStatus({ strategy })` | Positions, weights, drift for a strategy | `StrategyStatusResult` |
+| `agent.getStrategies()` | List all available strategies | `StrategyDefinition[]` |
+| `agent.createStrategy({ name, allocations, description? })` | Create a custom strategy | `StrategyDefinition` |
+| `agent.deleteStrategy({ name })` | Delete a custom strategy (no active positions) | `void` |
+
+### Auto-Invest (DCA) Methods
+
+| Method | Description | Returns |
+|--------|-------------|---------|
+| `agent.setupAutoInvest({ amount, frequency, strategy?, asset? })` | Schedule recurring purchases | `AutoInvestSchedule` |
+| `agent.getAutoInvestStatus()` | View schedules and pending runs | `AutoInvestStatus` |
+| `agent.runAutoInvest()` | Execute all pending DCA purchases | `AutoInvestRunResult` |
+| `agent.stopAutoInvest({ id? })` | Stop one or all schedules | `void` |
 
 ### Key Management
 
@@ -383,7 +420,7 @@ Fees are collected by the t2000 protocol treasury on-chain.
 
 ## MCP Server
 
-The SDK powers the [`@t2000/mcp`](https://www.npmjs.com/package/@t2000/mcp) server — 19 tools and 6 prompts for Claude Desktop, Cursor, and any MCP-compatible AI platform. Run `t2000 mcp` to start.
+The SDK powers the [`@t2000/mcp`](https://www.npmjs.com/package/@t2000/mcp) server — 21 tools and 6 prompts for Claude Desktop, Cursor, and any MCP-compatible AI platform. Run `t2000 mcp` to start.
 
 ## License
 

package/dist/adapters/index.cjs

@@ -1488,12 +1488,13 @@ var SuilendAdapter = class {
     if (!reserve) throw new T2000Error("ASSET_NOT_SUPPORTED", `${assetInfo.displayName} reserve not found on Suilend`);
     const caps = await this.fetchObligationCaps(address);
     if (caps.length === 0) throw new T2000Error("NO_COLLATERAL", "No Suilend position found");
-    const positions = await this.getPositions(address);
-    const deposited = positions.supplies.find((s) => s.asset === assetKey)?.amount ?? 0;
+    const obligation = await this.fetchObligation(caps[0].obligationId);
+    const dep = obligation.deposits.find((d) => d.reserveIdx === reserve.arrayIndex);
+    const ratio = cTokenRatio(reserve);
+    const deposited = dep ? dep.ctokenAmount * ratio / 10 ** reserve.mintDecimals : 0;
     const effectiveAmount = Math.min(amount, deposited);
     if (effectiveAmount <= 0) throw new T2000Error("NO_COLLATERAL", `Nothing to withdraw for ${assetInfo.displayName} on Suilend`);
-    const ratio = cTokenRatio(reserve);
-    const ctokenAmount = Math.ceil(effectiveAmount * 10 ** reserve.mintDecimals / ratio);
+    const ctokenAmount = dep && effectiveAmount >= deposited * 0.999 ? dep.ctokenAmount : Math.floor(effectiveAmount * 10 ** reserve.mintDecimals / ratio);
     const tx = new transactions.Transaction();
     tx.setSender(address);
     const [ctokens] = tx.moveCall({
@@ -1534,12 +1535,13 @@ var SuilendAdapter = class {
     if (!reserve) throw new T2000Error("ASSET_NOT_SUPPORTED", `${assetInfo.displayName} reserve not found on Suilend`);
     const caps = await this.fetchObligationCaps(address);
     if (caps.length === 0) throw new T2000Error("NO_COLLATERAL", "No Suilend position found");
-    const positions = await this.getPositions(address);
-    const deposited = positions.supplies.find((s) => s.asset === assetKey)?.amount ?? 0;
+    const obligation = await this.fetchObligation(caps[0].obligationId);
+    const dep = obligation.deposits.find((d) => d.reserveIdx === reserve.arrayIndex);
+    const ratio = cTokenRatio(reserve);
+    const deposited = dep ? dep.ctokenAmount * ratio / 10 ** reserve.mintDecimals : 0;
     const effectiveAmount = Math.min(amount, deposited);
     if (effectiveAmount <= 0) throw new T2000Error("NO_COLLATERAL", `Nothing to withdraw for ${assetInfo.displayName} on Suilend`);
-    const ratio = cTokenRatio(reserve);
-    const ctokenAmount = Math.ceil(effectiveAmount * 10 ** reserve.mintDecimals / ratio);
+    const ctokenAmount = dep && effectiveAmount >= deposited * 0.999 ? dep.ctokenAmount : Math.floor(effectiveAmount * 10 ** reserve.mintDecimals / ratio);
     const [ctokens] = tx.moveCall({
       target: `${pkg}::lending_market::withdraw_ctokens`,
       typeArguments: [LENDING_MARKET_TYPE, assetInfo.type],