dexbot 1.4.11 → 1.4.13

package/claw/examples/claw_infra_example.ts

@@ -0,0 +1,53 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+const { createClawInfrastructure } = require('../modules/claw_infra');
+const { getErrorMessage } = require('../../modules/utils/errors');
+
+async function main() {
+  const accountName = process.argv[2] || null;
+  const pair = process.argv[3] || 'BTS/USD';
+  const [baseSymbol, quoteSymbol] = pair.split('/');
+
+  const infra = createClawInfrastructure({
+    accountName
+  });
+
+  console.log(JSON.stringify({
+    credential: {
+      readyFilePath: infra.credential.readyFilePath,
+      socketPath: infra.credential.socketPath
+    },
+    runtime: infra.runtime,
+    stateFile: infra.stateStore.filePath
+  }, null, 2));
+
+  const globals = await infra.market.getDynamicGlobalProperties();
+  console.log('Head block number:', globals.head_block_number);
+
+  if (accountName) {
+    const accountSnapshot = await infra.market.readAccountSnapshot(accountName);
+    console.log(JSON.stringify({
+      accountId: accountSnapshot.account && accountSnapshot.account.account ? accountSnapshot.account.account.id : null,
+      balances: accountSnapshot.balances,
+      openOrders: accountSnapshot.openOrders.length
+    }, null, 2));
+  }
+
+  if (baseSymbol && quoteSymbol) {
+    const marketSnapshot = await infra.market.readMarketSnapshot(baseSymbol, quoteSymbol, 5);
+    console.log(JSON.stringify({
+      orderBookDepth: {
+        asks: Array.isArray(marketSnapshot.orderBook.asks) ? marketSnapshot.orderBook.asks.length : 0,
+        bids: Array.isArray(marketSnapshot.orderBook.bids) ? marketSnapshot.orderBook.bids.length : 0
+      },
+      tickerLatest: marketSnapshot.ticker ? marketSnapshot.ticker.latest : null
+    }, null, 2));
+  }
+}
+
+main().catch((err) => {
+  console.error(getErrorMessage(err));
+  process.exit(1);
+});
+export {};

package/claw/examples/claw_profiles_example.ts

@@ -0,0 +1,44 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+const { createClawInfrastructure } = require('../modules/claw_infra');
+const { getErrorMessage } = require('../../modules/utils/errors');
+
+async function main() {
+  const profileRoot = process.argv[2] || process.env.DEXBOT_PROFILE_ROOT || null;
+  const botRef = process.argv[3] || null;
+
+  const claw = createClawInfrastructure({
+    profileRoot,
+    runtime: {
+      name: 'claw-profiles',
+      profileRoot
+    }
+  });
+
+  const context = await claw.profiles.getClawProfileContext(botRef);
+
+  console.log(JSON.stringify({
+    profileRoot: context.profileRoot,
+    runtime: context.runtime,
+    selectedBot: context.selectedBot,
+    selectedBotFiles: context.selectedBotFiles,
+    selectedBotState: {
+      hasAmaProfile: Boolean(context.selectedBotState && context.selectedBotState.selectedAmaProfile),
+      orderSnapshotLoaded: Boolean(context.selectedBotState && context.selectedBotState.orderSnapshot),
+      gridPriceSnapshotLoaded: Boolean(context.selectedBotState && context.selectedBotState.gridPriceSnapshot),
+      triggerExists: Boolean(context.selectedBotState && context.selectedBotState.triggerExists)
+    },
+    summary: context.summary,
+    settings: {
+      activeBotCount: context.settings && context.settings.bots ? context.settings.bots.filter((bot) => bot.active !== false).length : 0,
+      generalSettingsKeys: context.settings && context.settings.general ? Object.keys(context.settings.general) : []
+    }
+  }, null, 2));
+}
+
+main().catch((err) => {
+  console.error(getErrorMessage(err));
+  process.exit(1);
+});
+export {};

package/claw/examples/connection_test.ts

@@ -0,0 +1,40 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+const {
+  getAsset,
+  getBalances,
+  getDynamicGlobalProperties,
+  getFullAccount,
+  getOrderBook
+} = require('../modules/chain_queries');
+const { getErrorMessage } = require('../../modules/utils/errors');
+
+async function main() {
+  const accountRef = process.argv[2];
+
+  const globals = await getDynamicGlobalProperties();
+  console.log('Connected to BitShares');
+  console.log('Head block number:', globals.head_block_number);
+
+  const bts = await getAsset('BTS');
+  console.log('BTS asset id:', bts ? bts.id : 'not found');
+  console.log('BTS precision:', bts ? bts.precision : 'not found');
+
+  const book = await getOrderBook('BTS', 'USD', 5);
+  console.log('Top BTS/USD bids:', Array.isArray(book.bids) ? book.bids.length : 0);
+  console.log('Top BTS/USD asks:', Array.isArray(book.asks) ? book.asks.length : 0);
+
+  if (accountRef) {
+    const full = await getFullAccount(accountRef);
+    const balances = await getBalances(accountRef);
+    console.log('Account id:', full && full.account ? full.account.id : 'not found');
+    console.log('Balances:', balances);
+  }
+}
+
+main().catch((err) => {
+  console.error(getErrorMessage(err));
+  process.exit(1);
+});
+export {};

package/claw/examples/honest_ecosystem_example.ts

@@ -0,0 +1,35 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+const { createClawInfrastructure } = require('../modules/claw_infra');
+const { getErrorMessage } = require('../../modules/utils/errors');
+
+async function main() {
+  const pair = process.argv[2] || 'HONEST.MONEY/BTS';
+  const [assetA, assetB] = pair.split('/');
+
+  const claw = createClawInfrastructure({
+    runtime: {
+      name: 'honest-ecosystem'
+    }
+  });
+
+  const context = await claw.honest.buildContext({
+    discoverPairs: [[assetA, assetB]]
+  });
+  const pairPrice = await claw.honest.resolvePairPrice(assetA, assetB);
+
+  console.log(JSON.stringify({
+    bridge: context.bridge,
+    pairContexts: context.pairContexts,
+    pair,
+    pairPrice,
+    summary: context.summary
+  }, null, 2));
+}
+
+main().catch((err) => {
+  console.error(getErrorMessage(err));
+  process.exit(1);
+});
+export {};

package/claw/examples/memu_integration_example.ts

@@ -0,0 +1,92 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+const { createMemuBridge } = require('../modules/memu_bridge');
+
+async function main() {
+  console.log('=== memU + DEXBot2 Integration Example ===\n');
+
+  const memu = createMemuBridge({
+    memuDir: process.env.MEMU_DIR || undefined,
+    llmProfiles: process.env.OPENAI_API_KEY
+      ? {
+          default: {
+            base_url: process.env.OPENAI_BASE_URL || 'https://api.openai.com/v1',
+            api_key: process.env.OPENAI_API_KEY,
+            chat_model: process.env.OPENAI_CHAT_MODEL || 'gpt-4o',
+            embed_model: process.env.OPENAI_EMBED_MODEL || 'text-embedding-3-small',
+            client_backend: 'sdk'
+          }
+        }
+      : undefined
+  });
+
+  console.log('memU bridge created');
+  console.log(`  memuDir: ${memu.memuDir}`);
+  console.log(`  stateDir: ${memu.stateDir}\n`);
+
+  try {
+    console.log('--- Step 1: Check memU status ---');
+    const status = await memu.getStatus();
+    console.log('Status:', JSON.stringify(status, null, 2));
+    console.log();
+
+    console.log('--- Step 2: Memorize a trading conversation ---');
+    const conversation = [
+      { role: 'user', content: 'I prefer BTS/USD grid bots with 2% increment and 70/30 sell/buy weight' },
+      { role: 'assistant', content: 'I will configure the grid bot with those settings.' },
+      { role: 'user', content: 'Also, I want to be notified if the price drops more than 5%' }
+    ];
+
+    const memorizeResult = await memu.memorizeConversation(conversation, { user_id: 'trader-001' });
+    console.log('Memorized conversation:', JSON.stringify(memorizeResult, null, 2));
+    console.log();
+
+    console.log('--- Step 3: Memorize trading context ---');
+    const tradingContext = {
+      bot: 'BTS/USD-grid',
+      event: 'grid_rebalanced',
+      details: {
+        oldIncrement: 0.015,
+        newIncrement: 0.02,
+        sellWeight: 0.7,
+        buyWeight: 0.3,
+        gridLevels: 25
+      },
+      timestamp: new Date().toISOString()
+    };
+
+    const contextResult = await memu.memorizeTradingContext(tradingContext, { user_id: 'trader-001' });
+    console.log('Memorized trading context:', JSON.stringify(contextResult, null, 2));
+    console.log();
+
+    console.log('--- Step 4: List categories ---');
+    const categories = await memu.listCategories({ user_id: 'trader-001' });
+    console.log('Categories:', JSON.stringify(categories, null, 2));
+    console.log();
+
+    console.log('--- Step 5: Retrieve trading context ---');
+    const retrievalResult = await memu.retrieveTradingContext(
+      'What are my preferences for BTS/USD grid bots?',
+      { user_id: 'trader-001' }
+    );
+    console.log('Retrieved context:', JSON.stringify(retrievalResult, null, 2));
+    console.log();
+
+    console.log('--- Step 6: List memory items ---');
+    const items = await memu.listItems({ user_id: 'trader-001' });
+    console.log('Memory items:', JSON.stringify(items, null, 2));
+    console.log();
+
+    console.log('=== Example completed successfully ===');
+  } catch (error) {
+    console.error('Error:', error.message);
+    console.error('\nNote: memU requires Python 3.13+ and the memu-py package.');
+    console.error('Install with: pip install memu-py');
+    console.error('Set OPENAI_API_KEY for LLM operations.');
+    process.exit(1);
+  }
+}
+
+main();
+export {};

package/claw/examples/position_manager_cli.ts

@@ -0,0 +1,129 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+const { DEFAULT_STATE_PATH, PositionManager } = require('../modules/position_manager');
+const { getErrorMessage } = require('../../modules/utils/errors');
+
+function parseArgs(argv: any) {
+  const options: any = {
+    statePath: DEFAULT_STATE_PATH
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    const next = argv[i + 1];
+
+    if (arg === '--mode' && next) {
+      options.mode = next;
+      i += 1;
+    } else if (arg === '--id' && next) {
+      options.positionId = next;
+      i += 1;
+    } else if (arg === '--account' && next) {
+      options.accountName = next;
+      i += 1;
+    } else if (arg === '--mpa' && next) {
+      options.mpaAsset = next;
+      i += 1;
+    } else if (arg === '--debt' && next) {
+      options.debtAmount = Number(next);
+      i += 1;
+    } else if (arg === '--collateral' && next) {
+      options.collateralAmount = Number(next);
+      i += 1;
+    } else if (arg === '--sell-price' && next) {
+      options.sellPriceInBts = Number(next);
+      i += 1;
+    } else if (arg === '--buy-price' && next) {
+      options.buyPriceInBts = Number(next);
+      i += 1;
+    } else if (arg === '--cover' && next) {
+      options.amountToCover = Number(next);
+      i += 1;
+    } else if (arg === '--repay' && next) {
+      options.amountToRepay = Number(next);
+      i += 1;
+    } else if (arg === '--release-collateral' && next) {
+      options.releaseCollateralDelta = Number(next);
+      i += 1;
+    } else if (arg === '--tcr' && next) {
+      options.targetCollateralRatio = Number(next);
+      i += 1;
+    } else if (arg === '--expiration' && next) {
+      options.expiration = next;
+      i += 1;
+    } else if (arg === '--fill-or-kill') {
+      options.fillOrKill = true;
+    } else if (arg === '--state' && next) {
+      options.statePath = next;
+      i += 1;
+    }
+  }
+
+  return options;
+}
+
+function printUsage() {
+  console.log('Position manager modes:');
+  console.log('  list');
+  console.log('  create --account ACCOUNT --mpa HONEST.USD --debt 10 --collateral 25000 --sell-price 1000');
+  console.log('  open --id POSITION_ID');
+  console.log('  tp --id POSITION_ID --buy-price 900 [--cover 10]');
+  console.log('  close --id POSITION_ID --repay 10 [--release-collateral 25000]');
+  console.log('  sync --id POSITION_ID');
+  console.log('  sync-all');
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const manager = new PositionManager({ statePath: options.statePath });
+  const mode = options.mode;
+
+  if (!mode || mode === 'help') {
+    printUsage();
+    return;
+  }
+
+  if (mode === 'list') {
+    console.log(JSON.stringify(await manager.listPositions(), null, 2));
+    return;
+  }
+
+  if (mode === 'create') {
+    console.log(JSON.stringify(await manager.createShortPosition(options), null, 2));
+    return;
+  }
+
+  if (mode === 'open') {
+    console.log(JSON.stringify(await manager.openShort(options.positionId, options), null, 2));
+    return;
+  }
+
+  if (mode === 'tp') {
+    console.log(JSON.stringify(await manager.placeTakeProfit(options.positionId, options), null, 2));
+    return;
+  }
+
+  if (mode === 'close') {
+    console.log(JSON.stringify(await manager.closePosition(options.positionId, options), null, 2));
+    return;
+  }
+
+  if (mode === 'sync') {
+    console.log(JSON.stringify(await manager.syncPosition(options.positionId), null, 2));
+    return;
+  }
+
+  if (mode === 'sync-all') {
+    console.log(JSON.stringify(await manager.syncAllPositions(), null, 2));
+    return;
+  }
+
+  throw new Error(`Unsupported mode: ${mode}`);
+}
+
+main().catch((err: any) => {
+  console.error(getErrorMessage(err));
+  process.exit(1);
+});
+export {};

package/claw/examples/short_mpa_bts_strategy.ts

@@ -0,0 +1,127 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+const {
+  buildCloseShortPlan,
+  buildOpenShortPlan,
+  buildTakeProfitPlan,
+  closeShortOnBts,
+  openShortOnBts,
+  placeTakeProfitBuyOrderOnBts
+} = require('../modules/short_mpa_strategy');
+const { getErrorMessage } = require('../../modules/utils/errors');
+
+function parseArgs(argv: string[]): Record<string, any> {
+  const options: Record<string, any> = {};
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    const next = argv[i + 1];
+
+    if (arg === '--execute') {
+      options.execute = true;
+    } else if (arg === '--mode' && next) {
+      options.mode = next;
+      i += 1;
+    } else if (arg === '--account' && next) {
+      options.accountName = next;
+      i += 1;
+    } else if (arg === '--mpa' && next) {
+      options.mpaAsset = next;
+      i += 1;
+    } else if (arg === '--debt' && next) {
+      options.debtAmount = Number(next);
+      i += 1;
+    } else if (arg === '--collateral' && next) {
+      options.collateralAmount = Number(next);
+      i += 1;
+    } else if (arg === '--sell-price' && next) {
+      options.sellPriceInBts = Number(next);
+      i += 1;
+    } else if (arg === '--cover' && next) {
+      options.amountToCover = Number(next);
+      i += 1;
+    } else if (arg === '--buy-price' && next) {
+      options.buyPriceInBts = Number(next);
+      i += 1;
+    } else if (arg === '--repay' && next) {
+      options.amountToRepay = Number(next);
+      i += 1;
+    } else if (arg === '--release-collateral' && next) {
+      options.releaseCollateralDelta = Number(next);
+      i += 1;
+    } else if (arg === '--tcr' && next) {
+      options.targetCollateralRatio = Number(next);
+      i += 1;
+    } else if (arg === '--expiration' && next) {
+      options.expiration = next;
+      i += 1;
+    } else if (arg === '--fill-or-kill') {
+      options.fillOrKill = true;
+    }
+  }
+
+  return options;
+}
+
+function printUsage() {
+  console.log('Usage examples:');
+  console.log('  tsx examples/short_mpa_bts_strategy.ts --mode open --mpa HONEST.USD --debt 10 --collateral 25000 --sell-price 1000');
+  console.log('  tsx examples/short_mpa_bts_strategy.ts --mode tp --mpa HONEST.USD --cover 10 --buy-price 900');
+  console.log('  tsx examples/short_mpa_bts_strategy.ts --mode close --mpa HONEST.USD --repay 10 --release-collateral 25000');
+  console.log('Add --execute to broadcast transactions. Without it, the script prints the plan only.');
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const mode = options.mode;
+
+  if (!mode || mode === 'help') {
+    printUsage();
+    process.exit(0);
+  }
+
+  if (mode === 'open') {
+    const plan = await buildOpenShortPlan(options);
+    console.log(JSON.stringify(plan, null, 2));
+    if (!options.execute) {
+      return;
+    }
+
+    const result = await openShortOnBts(options);
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (mode === 'tp') {
+    const plan = await buildTakeProfitPlan(options);
+    console.log(JSON.stringify(plan, null, 2));
+    if (!options.execute) {
+      return;
+    }
+
+    const result = await placeTakeProfitBuyOrderOnBts(options);
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (mode === 'close') {
+    const plan = await buildCloseShortPlan(options);
+    console.log(JSON.stringify(plan, null, 2));
+    if (!options.execute) {
+      return;
+    }
+
+    const result = await closeShortOnBts(options);
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  throw new Error(`Unsupported mode: ${mode}`);
+}
+
+main().catch((err) => {
+  console.error(getErrorMessage(err));
+  process.exit(1);
+});
+export {};

package/claw/examples/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "node16",
+    "lib": ["ES2022"],
+    "strict": false,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "noImplicitAny": false,
+    "noImplicitThis": false,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node16",
+    "types": ["node"],
+    "allowJs": false,
+    "noEmit": true
+  },
+  "include": [
+    "**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/claw/index.ts

@@ -0,0 +1,64 @@
+
+
+import * as bitsharesClient from './modules/bitshares_client.js';
+import * as chainActions from './modules/chain_actions.js';
+import * as chainBroadcast from './modules/chain_broadcast.js';
+import * as chainQueries from './modules/chain_queries.js';
+import * as clawBridge from './modules/claw_bridge.js';
+import * as clawCatalog from './modules/claw_catalog.js';
+import * as clawInfra from './modules/claw_infra.js';
+import * as clawManifest from './modules/claw_manifest.js';
+import * as clawRuntimeMatrix from './modules/claw_runtime_matrix.js';
+import * as clawSkillMd from './modules/claw_skill_md.js';
+import * as creditRuntimeAdapter from './modules/credit_runtime_adapter.js';
+import * as decisionLoop from './modules/decision_loop.js';
+import * as dexbotBridge from './modules/dexbot_bridge.js';
+import * as dexbotCredentialClient from './modules/dexbot_credential_client.js';
+import * as dexbotProfiles from './modules/dexbot_profiles.js';
+import * as feedPriceSource from './modules/feed_price_source.js';
+import * as honestEcosystem from './modules/honest_ecosystem.js';
+import * as kibanaPriceSource from './modules/kibana_price_source.js';
+import * as liquidityPools from './modules/liquidity_pools.js';
+import * as memuBridge from './modules/memu_bridge.js';
+import * as positionDiscovery from './modules/position_discovery.js';
+import * as positionHealth from './modules/position_health.js';
+import * as positionManager from './modules/position_manager.js';
+import * as positionManagerWatch from './modules/position_manager_watch.js';
+import * as shortMpaStrategy from './modules/short_mpa_strategy.js';
+const _default = {
+  ...bitsharesClient,
+  ...chainActions,
+  ...chainBroadcast,
+  ...chainQueries,
+  ...clawBridge,
+  ...clawCatalog,
+  ...clawInfra,
+  ...clawManifest,
+  ...clawRuntimeMatrix,
+  ...clawSkillMd,
+  ...creditRuntimeAdapter,
+  ...decisionLoop,
+  ...dexbotBridge,
+  ...dexbotCredentialClient,
+  ...dexbotProfiles,
+  ...feedPriceSource,
+  ...honestEcosystem,
+  ...kibanaPriceSource,
+  ...liquidityPools,
+  ...memuBridge,
+  ...positionDiscovery,
+  ...positionHealth,
+  ...positionManager,
+  ...positionManagerWatch,
+  ...shortMpaStrategy,
+
+  // Disambiguate root exports that would otherwise be overwritten by spread order.
+  describeClawBridge: clawManifest.describeClawBridge,
+  describeMemuBridge: memuBridge.describeMemuBridge,
+  resolveAccountName: chainQueries.resolveAccountName,
+  resolveSigningAccountName: chainBroadcast.resolveAccountName
+};
+export default _default;
+// CJS compatibility - tsx/require gets the object directly
+
+