@clonegod/ttd-sui-common 1.0.101 → 2.0.1

package/dist/trade/check/tx_result_checker.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionResultChecker = void 0;
 const dist_1 = require("@clonegod/ttd-core/dist");
@@ -21,50 +12,51 @@ class TransactionResultChecker extends trade_1.AbstractTransactionResultCheck {
         this.leadgerService = ledgerService;
     }
     isValidTransactionResult(txReceipt) {
-        var _a, _b, _c, _d;
-        const success = (_c = (_b = (_a = txReceipt.transaction) === null || _a === void 0 ? void 0 : _a.effects) === null || _b === void 0 ? void 0 : _b.status) === null || _c === void 0 ? void 0 : _c.success;
-        const balance_changes = (_d = txReceipt.transaction) === null || _d === void 0 ? void 0 : _d.balance_changes;
-        return !success || (success && balance_changes && balance_changes.length > 0);
+        const success = txReceipt.transaction?.effects?.status?.success;
+        const balance_changes = txReceipt.transaction?.balance_changes;
+        if (success === true)
+            return !!(balance_changes && balance_changes.length > 0);
+        if (success === false)
+            return true;
+        return false;
     }
-    check_tx_result_interval() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const check_start_time = Date.now();
-            const check_interval = parseInt(process.env.CHECK_TX_RESULT_INTERVAL_MILLS || '3000');
-            const check_timeout = parseInt(process.env.CHECK_TX_RESULT_TIMEOUT_MILLS || '30000');
-            if (check_interval >= check_timeout) {
-                return;
-            }
-            const intervalId = setInterval(() => __awaiter(this, void 0, void 0, function* () {
-                this.check_count += 1;
-                (0, dist_1.log_info)(`check transaction start: seq=[${this.check_count}], txhash= ${this.txid}, trace_id=${this.trace_id}`);
-                try {
-                    if (Date.now() - check_start_time < check_timeout) {
-                        let txReceipt = yield this.leadgerService.getTransaction(this.txid, ['*']);
-                        if (!txReceipt || (0, dist_1.isEmpty)(txReceipt)) {
-                            return;
-                        }
-                        txReceipt['transaction']['signatures'] = [];
-                        txReceipt = (0, index_1.decodeBytes)(txReceipt);
-                        (0, dist_1.log_info)(`Received transaction result via polling: ${this.txid}`);
-                        if (this.isValidTransactionResult(txReceipt)) {
-                            clearInterval(intervalId);
-                            yield this.processTransactionResult(txReceipt, 'interval');
-                        }
+    async check_tx_result_interval() {
+        const check_start_time = Date.now();
+        const check_interval = parseInt(process.env.CHECK_TX_RESULT_INTERVAL_MILLS || '3000');
+        const check_timeout = parseInt(process.env.CHECK_TX_RESULT_TIMEOUT_MILLS || '30000');
+        if (check_interval >= check_timeout) {
+            return;
+        }
+        const intervalId = setInterval(async () => {
+            this.check_count += 1;
+            (0, dist_1.log_info)(`check transaction start: seq=[${this.check_count}], txhash= ${this.txid}, trace_id=${this.trace_id}`);
+            try {
+                if (Date.now() - check_start_time < check_timeout) {
+                    let txReceipt = await this.leadgerService.getTransaction(this.txid, ['*']);
+                    if (!txReceipt || (0, dist_1.isEmpty)(txReceipt)) {
+                        return;
                     }
-                    else {
+                    txReceipt['transaction']['signatures'] = [];
+                    txReceipt = (0, index_1.decodeBytes)(txReceipt);
+                    (0, dist_1.log_info)(`Received transaction result via polling: ${this.txid}`);
+                    if (this.isValidTransactionResult(txReceipt)) {
                         clearInterval(intervalId);
+                        await this.processTransactionResult(txReceipt, 'interval');
                     }
                 }
-                catch (err) {
+                else {
                     clearInterval(intervalId);
-                    (0, dist_1.log_error)('parse transaction error!', err);
                 }
-            }), check_interval);
-            this.intervalId = intervalId;
-        });
+            }
+            catch (err) {
+                clearInterval(intervalId);
+                (0, dist_1.log_error)('parse transaction error!', err);
+            }
+        }, check_interval);
+        this.intervalId = intervalId;
     }
     on_subscibe_transaction() {
-        this.event_emitter.once(`SUI_TX_RESULT_${this.txid}`, (response) => __awaiter(this, void 0, void 0, function* () {
+        this.event_emitter.once(`SUI_TX_RESULT_${this.txid}`, async (response) => {
             (0, dist_1.log_info)(`receive tx result notification, txid=${this.txid}`);
             if (response.transaction) {
                 this.processTransactionResult(response, 'grpc');
@@ -73,7 +65,7 @@ class TransactionResultChecker extends trade_1.AbstractTransactionResultCheck {
             for (let i = 1; i <= 6; i++) {
                 (0, dist_1.log_info)(`re-fetch tx result by ledgerService start, i=${i}, txid=${this.txid}`);
                 try {
-                    let txReceipt = yield this.leadgerService.getTransaction(this.txid, ['*']);
+                    let txReceipt = await this.leadgerService.getTransaction(this.txid, ['*']);
                     if (!txReceipt || (0, dist_1.isEmpty)(txReceipt)) {
                         console.log('txReceipt is empty', txReceipt);
                         continue;
@@ -90,38 +82,36 @@ class TransactionResultChecker extends trade_1.AbstractTransactionResultCheck {
                 catch (error) {
                     (0, dist_1.log_warn)(`re-fetch tx result by ledgerService failed, i=${i}, txid=${this.txid}, error=${error.message}`);
                 }
-                yield (0, dist_1.sleep)(1000);
+                await (0, dist_1.sleep)(1000);
             }
-        }));
-    }
-    processTransactionResult(txReceipt, source) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (this.trade_result_already_processed) {
-                (0, dist_1.log_warn)(`trade_result_already_processed=${this.trade_result_already_processed}, ignore trade result fetch by ${source} check!`);
-                return;
-            }
-            const swap_detail = yield this.transactionParser.parseTransaction(txReceipt, this.pool_info);
-            let trade_result = this.map_swap_result_to_tx_result(swap_detail);
-            this.trade_result_already_processed = true;
-            if (this.intervalId) {
-                clearInterval(this.intervalId);
-                this.intervalId = null;
-            }
-            if (trade_result.success) {
-                this.event_emitter.emit(dist_1.TRANSACTION_STATE_SUCCESS, trade_result);
-            }
-            else {
-                this.event_emitter.emit(dist_1.TRANSACTION_STATE_FAILED, trade_result);
-            }
-            if (source === 'interval') {
-                console.log('--------------------- Transaction Result from Polling ---------------------');
-            }
-            else {
-                console.log('--------------------- Transaction Result from GRPC ---------------------');
-            }
-            console.log(JSON.stringify(trade_result, null, 2));
-            console.log('-----------------------------------------------------------------------------');
         });
     }
+    async processTransactionResult(txReceipt, source) {
+        if (this.trade_result_already_processed) {
+            (0, dist_1.log_warn)(`trade_result_already_processed=${this.trade_result_already_processed}, ignore trade result fetch by ${source} check!`);
+            return;
+        }
+        const swap_detail = await this.transactionParser.parseTransaction(txReceipt, this.pool_info);
+        let trade_result = this.map_swap_result_to_tx_result(swap_detail);
+        this.trade_result_already_processed = true;
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        if (trade_result.success) {
+            this.event_emitter.emit(dist_1.TRANSACTION_STATE_SUCCESS, trade_result);
+        }
+        else {
+            this.event_emitter.emit(dist_1.TRANSACTION_STATE_FAILED, trade_result);
+        }
+        if (source === 'interval') {
+            console.log('--------------------- Transaction Result from Polling ---------------------');
+        }
+        else {
+            console.log('--------------------- Transaction Result from GRPC ---------------------');
+        }
+        console.log(JSON.stringify(trade_result, null, 2));
+        console.log('-----------------------------------------------------------------------------');
+    }
 }
 exports.TransactionResultChecker = TransactionResultChecker;

package/dist/trade/coin/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/dist/trade/coin/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);

package/dist/trade/coin/lua_scripts.d.ts

@@ -0,0 +1,5 @@
+export declare const LUA_ACQUIRE = "\nlocal availKey, metaKey, inflightKey = KEYS[1], KEYS[2], KEYS[3]\nlocal amount = tonumber(ARGV[1])\nlocal txTag, coinType, now = ARGV[2], ARGV[3], ARGV[4]\nlocal maxCoins = tonumber(ARGV[5])\nlocal ids = redis.call('ZRANGE', availKey, 0, -1)\nlocal picked, sum = {}, 0\nlocal i = #ids\nwhile i >= 1 do\n  local id = ids[i]\n  local m = redis.call('HGET', metaKey, id)\n  if m then\n    local meta = cjson.decode(m)\n    picked[#picked+1] = { id = id, v = meta.v, d = meta.d, b = meta.b }\n    sum = sum + tonumber(meta.b)\n    if sum >= amount then break end\n    if #picked >= maxCoins then break end\n  end\n  i = i - 1\nend\nif sum < amount then return redis.error_reply('INSUFFICIENT_COINS') end\nlocal out = {}\nfor _, p in ipairs(picked) do\n  redis.call('ZREM', availKey, p.id)\n  redis.call('HDEL', metaKey, p.id)\n  redis.call('HSET', inflightKey, p.id, cjson.encode({ tag = txTag, ct = coinType, t = now, v = p.v, d = p.d, b = p.b }))\n  out[#out+1] = cjson.encode({ objectId = p.id, version = p.v, digest = p.d, balance = p.b })\nend\nreturn out\n";
+export declare const LUA_ACQUIRE_GAS = "\nlocal availKey, metaKey, inflightKey = KEYS[1], KEYS[2], KEYS[3]\nlocal minGas = tonumber(ARGV[1])\nlocal txTag, now = ARGV[2], ARGV[3]\nlocal ids = redis.call('ZRANGEBYSCORE', availKey, minGas, '+inf', 'LIMIT', 0, 1)\nif #ids == 0 then return redis.error_reply('NO_GAS_COIN') end\nlocal id = ids[1]\nlocal m = redis.call('HGET', metaKey, id)\nif not m then return redis.error_reply('NO_GAS_META') end\nlocal meta = cjson.decode(m)\nredis.call('ZREM', availKey, id)\nredis.call('HDEL', metaKey, id)\nredis.call('HSET', inflightKey, id, cjson.encode({ tag = txTag, ct = 'gas', t = now, v = meta.v, d = meta.d, b = meta.b }))\nreturn cjson.encode({ objectId = id, version = meta.v, digest = meta.d, balance = meta.b })\n";
+export declare const LUA_COMMIT = "\nlocal inflightKey = KEYS[1]\nlocal base, gasBase, wallet = ARGV[1], ARGV[2], ARGV[3]\nlocal changes = cjson.decode(ARGV[4])\nfor _, c in ipairs(changes) do\n  local availKey, metaKey\n  if c.gas then\n    availKey = gasBase..':avail:{'..wallet..'}'\n    metaKey  = gasBase..':meta:{'..wallet..'}'\n  else\n    availKey = base..':avail:{'..wallet..'}:'..c.coinType\n    metaKey  = base..':meta:{'..wallet..'}:'..c.coinType\n  end\n  redis.call('HDEL', inflightKey, c.objectId)\n  if c.kind == 'deleted' then\n    redis.call('ZREM', availKey, c.objectId)\n    redis.call('HDEL', metaKey, c.objectId)\n  else\n    redis.call('ZADD', availKey, tonumber(c.b), c.objectId)\n    redis.call('HSET', metaKey, c.objectId, cjson.encode({ v = c.v, d = c.d, b = c.b }))\n  end\nend\nreturn 'OK'\n";
+export declare const LUA_ABORT = "\nlocal inflightKey = KEYS[1]\nlocal base, gasBase, wallet, txTag, consumed = ARGV[1], ARGV[2], ARGV[3], ARGV[4], ARGV[5]\nlocal all = redis.call('HGETALL', inflightKey)\nfor i = 1, #all, 2 do\n  local objectId, info = all[i], cjson.decode(all[i+1])\n  if info.tag == txTag then\n    redis.call('HDEL', inflightKey, objectId)\n    if consumed == '0' then\n      local availKey, metaKey\n      if info.ct == 'gas' then\n        availKey = gasBase..':avail:{'..wallet..'}'\n        metaKey  = gasBase..':meta:{'..wallet..'}'\n      else\n        availKey = base..':avail:{'..wallet..'}:'..info.ct\n        metaKey  = base..':meta:{'..wallet..'}:'..info.ct\n      end\n      redis.call('ZADD', availKey, tonumber(info.b), objectId)\n      redis.call('HSET', metaKey, objectId, cjson.encode({ v = info.v, d = info.d, b = info.b }))\n    end\n  end\nend\nreturn 'OK'\n";
+export declare const LUA_RECONCILE = "\nlocal availKey, metaKey, inflightKey = KEYS[1], KEYS[2], KEYS[3]\nlocal chain = cjson.decode(ARGV[1])\nlocal ttl, now = tonumber(ARGV[2]), tonumber(ARGV[3])\nlocal chainSet = {}\nfor _, o in ipairs(chain) do chainSet[o.objectId] = o end\n-- \u5904\u7406 inflight\uFF1A\u8D85\u65F6\u79FB\u51FA\uFF08\u89C6\u4F5C\u4E22\u5931\uFF0C\u94FE\u771F\u503C\u4F1A\u91CD\u52A0\uFF09\uFF1B\u5426\u5219\u8BB0\u5165 inflightSet \u4FDD\u62A4\nlocal inflight = redis.call('HGETALL', inflightKey)\nlocal inflightSet = {}\nfor i = 1, #inflight, 2 do\n  local oid, info = inflight[i], cjson.decode(inflight[i+1])\n  if (now - tonumber(info.t)) > ttl then\n    redis.call('HDEL', inflightKey, oid)\n  else\n    inflightSet[oid] = true\n  end\nend\n-- \u5220\u9664 avail \u4E2D\u94FE\u4E0A\u5DF2\u65E0\u4E14\u975E inflight \u7684\nlocal availIds = redis.call('ZRANGE', availKey, 0, -1)\nfor _, id in ipairs(availIds) do\n  if not chainSet[id] then\n    redis.call('ZREM', availKey, id)\n    redis.call('HDEL', metaKey, id)\n  end\nend\n-- \u52A0\u5165/\u66F4\u65B0\u94FE\u4E0A\u6709\u4E14\u975E inflight \u7684\nfor _, o in ipairs(chain) do\n  if not inflightSet[o.objectId] then\n    redis.call('ZADD', availKey, tonumber(o.b), o.objectId)\n    redis.call('HSET', metaKey, o.objectId, cjson.encode({ v = o.v, d = o.d, b = o.b }))\n  end\nend\nreturn 'OK'\n";

package/dist/trade/coin/lua_scripts.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LUA_RECONCILE = exports.LUA_ABORT = exports.LUA_COMMIT = exports.LUA_ACQUIRE_GAS = exports.LUA_ACQUIRE = void 0;
+exports.LUA_ACQUIRE = `
+local availKey, metaKey, inflightKey = KEYS[1], KEYS[2], KEYS[3]
+local amount = tonumber(ARGV[1])
+local txTag, coinType, now = ARGV[2], ARGV[3], ARGV[4]
+local maxCoins = tonumber(ARGV[5])
+local ids = redis.call('ZRANGE', availKey, 0, -1)
+local picked, sum = {}, 0
+local i = #ids
+while i >= 1 do
+  local id = ids[i]
+  local m = redis.call('HGET', metaKey, id)
+  if m then
+    local meta = cjson.decode(m)
+    picked[#picked+1] = { id = id, v = meta.v, d = meta.d, b = meta.b }
+    sum = sum + tonumber(meta.b)
+    if sum >= amount then break end
+    if #picked >= maxCoins then break end
+  end
+  i = i - 1
+end
+if sum < amount then return redis.error_reply('INSUFFICIENT_COINS') end
+local out = {}
+for _, p in ipairs(picked) do
+  redis.call('ZREM', availKey, p.id)
+  redis.call('HDEL', metaKey, p.id)
+  redis.call('HSET', inflightKey, p.id, cjson.encode({ tag = txTag, ct = coinType, t = now, v = p.v, d = p.d, b = p.b }))
+  out[#out+1] = cjson.encode({ objectId = p.id, version = p.v, digest = p.d, balance = p.b })
+end
+return out
+`;
+exports.LUA_ACQUIRE_GAS = `
+local availKey, metaKey, inflightKey = KEYS[1], KEYS[2], KEYS[3]
+local minGas = tonumber(ARGV[1])
+local txTag, now = ARGV[2], ARGV[3]
+local ids = redis.call('ZRANGEBYSCORE', availKey, minGas, '+inf', 'LIMIT', 0, 1)
+if #ids == 0 then return redis.error_reply('NO_GAS_COIN') end
+local id = ids[1]
+local m = redis.call('HGET', metaKey, id)
+if not m then return redis.error_reply('NO_GAS_META') end
+local meta = cjson.decode(m)
+redis.call('ZREM', availKey, id)
+redis.call('HDEL', metaKey, id)
+redis.call('HSET', inflightKey, id, cjson.encode({ tag = txTag, ct = 'gas', t = now, v = meta.v, d = meta.d, b = meta.b }))
+return cjson.encode({ objectId = id, version = meta.v, digest = meta.d, balance = meta.b })
+`;
+exports.LUA_COMMIT = `
+local inflightKey = KEYS[1]
+local base, gasBase, wallet = ARGV[1], ARGV[2], ARGV[3]
+local changes = cjson.decode(ARGV[4])
+for _, c in ipairs(changes) do
+  local availKey, metaKey
+  if c.gas then
+    availKey = gasBase..':avail:{'..wallet..'}'
+    metaKey  = gasBase..':meta:{'..wallet..'}'
+  else
+    availKey = base..':avail:{'..wallet..'}:'..c.coinType
+    metaKey  = base..':meta:{'..wallet..'}:'..c.coinType
+  end
+  redis.call('HDEL', inflightKey, c.objectId)
+  if c.kind == 'deleted' then
+    redis.call('ZREM', availKey, c.objectId)
+    redis.call('HDEL', metaKey, c.objectId)
+  else
+    redis.call('ZADD', availKey, tonumber(c.b), c.objectId)
+    redis.call('HSET', metaKey, c.objectId, cjson.encode({ v = c.v, d = c.d, b = c.b }))
+  end
+end
+return 'OK'
+`;
+exports.LUA_ABORT = `
+local inflightKey = KEYS[1]
+local base, gasBase, wallet, txTag, consumed = ARGV[1], ARGV[2], ARGV[3], ARGV[4], ARGV[5]
+local all = redis.call('HGETALL', inflightKey)
+for i = 1, #all, 2 do
+  local objectId, info = all[i], cjson.decode(all[i+1])
+  if info.tag == txTag then
+    redis.call('HDEL', inflightKey, objectId)
+    if consumed == '0' then
+      local availKey, metaKey
+      if info.ct == 'gas' then
+        availKey = gasBase..':avail:{'..wallet..'}'
+        metaKey  = gasBase..':meta:{'..wallet..'}'
+      else
+        availKey = base..':avail:{'..wallet..'}:'..info.ct
+        metaKey  = base..':meta:{'..wallet..'}:'..info.ct
+      end
+      redis.call('ZADD', availKey, tonumber(info.b), objectId)
+      redis.call('HSET', metaKey, objectId, cjson.encode({ v = info.v, d = info.d, b = info.b }))
+    end
+  end
+end
+return 'OK'
+`;
+exports.LUA_RECONCILE = `
+local availKey, metaKey, inflightKey = KEYS[1], KEYS[2], KEYS[3]
+local chain = cjson.decode(ARGV[1])
+local ttl, now = tonumber(ARGV[2]), tonumber(ARGV[3])
+local chainSet = {}
+for _, o in ipairs(chain) do chainSet[o.objectId] = o end
+-- 处理 inflight：超时移出（视作丢失，链真值会重加）；否则记入 inflightSet 保护
+local inflight = redis.call('HGETALL', inflightKey)
+local inflightSet = {}
+for i = 1, #inflight, 2 do
+  local oid, info = inflight[i], cjson.decode(inflight[i+1])
+  if (now - tonumber(info.t)) > ttl then
+    redis.call('HDEL', inflightKey, oid)
+  else
+    inflightSet[oid] = true
+  end
+end
+-- 删除 avail 中链上已无且非 inflight 的
+local availIds = redis.call('ZRANGE', availKey, 0, -1)
+for _, id in ipairs(availIds) do
+  if not chainSet[id] then
+    redis.call('ZREM', availKey, id)
+    redis.call('HDEL', metaKey, id)
+  end
+end
+-- 加入/更新链上有且非 inflight 的
+for _, o in ipairs(chain) do
+  if not inflightSet[o.objectId] then
+    redis.call('ZADD', availKey, tonumber(o.b), o.objectId)
+    redis.call('HSET', metaKey, o.objectId, cjson.encode({ v = o.v, d = o.d, b = o.b }))
+  end
+end
+return 'OK'
+`;

package/dist/trade/coin/types.d.ts

@@ -0,0 +1,30 @@
+export interface CoinRef {
+    objectId: string;
+    version: string;
+    digest: string;
+    balance: string;
+}
+export interface CoinReservation {
+    txTag: string;
+    coinType: string;
+    coins: CoinRef[];
+}
+export interface GasReservation {
+    txTag: string;
+    coin: CoinRef;
+}
+export interface CoinObjectChange {
+    kind: 'mutated' | 'created' | 'deleted';
+    objectId: string;
+    coinType: string;
+    version?: string;
+    digest?: string;
+    balance?: string;
+    gas?: boolean;
+}
+export interface LedgerOptions {
+    keyBase?: string;
+    gasBase?: string;
+    inflightTtlMs?: number;
+    maxCoinsPerAcquire?: number;
+}

package/dist/trade/coin/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/trade/coin/wallet_coin_ledger.d.ts

@@ -0,0 +1,22 @@
+import { RedisClientType } from 'redis';
+import { CoinObjectChange, CoinRef, CoinReservation, GasReservation, LedgerOptions } from './types';
+export declare class WalletCoinLedger {
+    private readonly getClient;
+    private readonly base;
+    private readonly gasBase;
+    private readonly inflightTtlMs;
+    private readonly maxCoins;
+    constructor(getClient: () => Promise<RedisClientType>, opts?: LedgerOptions);
+    private availKey;
+    private metaKey;
+    private inflightKey;
+    private gasAvailKey;
+    private gasMetaKey;
+    private newTxTag;
+    acquire(wallet: string, coinType: string, amount: bigint | string, txTag?: string): Promise<CoinReservation>;
+    acquireGas(wallet: string, minGas: bigint | string, txTag?: string): Promise<GasReservation>;
+    commit(wallet: string, changes: CoinObjectChange[]): Promise<void>;
+    abort(wallet: string, txTag: string, consumed: boolean): Promise<void>;
+    reconcile(wallet: string, coinType: string, chainObjs: CoinRef[], isGas?: boolean): Promise<void>;
+    availableCount(wallet: string, coinType: string, isGas?: boolean): Promise<number>;
+}

package/dist/trade/coin/wallet_coin_ledger.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletCoinLedger = void 0;
+const dist_1 = require("@clonegod/ttd-core/dist");
+const lua_scripts_1 = require("./lua_scripts");
+class WalletCoinLedger {
+    constructor(getClient, opts = {}) {
+        this.getClient = getClient;
+        this.base = opts.keyBase ?? 'sui:coin';
+        this.gasBase = opts.gasBase ?? 'sui:gas';
+        this.inflightTtlMs = opts.inflightTtlMs ?? 30000;
+        this.maxCoins = opts.maxCoinsPerAcquire ?? 8;
+    }
+    availKey(wallet, coinType) { return `${this.base}:avail:{${wallet}}:${coinType}`; }
+    metaKey(wallet, coinType) { return `${this.base}:meta:{${wallet}}:${coinType}`; }
+    inflightKey(wallet) { return `${this.base}:inflight:{${wallet}}`; }
+    gasAvailKey(wallet) { return `${this.gasBase}:avail:{${wallet}}`; }
+    gasMetaKey(wallet) { return `${this.gasBase}:meta:{${wallet}}`; }
+    newTxTag(wallet) {
+        return `${wallet.slice(2, 8)}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    }
+    async acquire(wallet, coinType, amount, txTag) {
+        const client = await this.getClient();
+        const tag = txTag ?? this.newTxTag(wallet);
+        try {
+            const reply = await client.eval(lua_scripts_1.LUA_ACQUIRE, {
+                keys: [this.availKey(wallet, coinType), this.metaKey(wallet, coinType), this.inflightKey(wallet)],
+                arguments: [String(amount), tag, coinType, String(Date.now()), String(this.maxCoins)],
+            });
+            const coins = (reply || []).map(s => JSON.parse(s));
+            return { txTag: tag, coinType, coins };
+        }
+        catch (e) {
+            throw new Error(`[coin-ledger] acquire failed wallet=${wallet} coinType=${coinType} amount=${amount}: ${e?.message || e}`);
+        }
+    }
+    async acquireGas(wallet, minGas, txTag) {
+        const client = await this.getClient();
+        const tag = txTag ?? this.newTxTag(wallet);
+        try {
+            const reply = await client.eval(lua_scripts_1.LUA_ACQUIRE_GAS, {
+                keys: [this.gasAvailKey(wallet), this.gasMetaKey(wallet), this.inflightKey(wallet)],
+                arguments: [String(minGas), tag, String(Date.now())],
+            });
+            return { txTag: tag, coin: JSON.parse(reply) };
+        }
+        catch (e) {
+            throw new Error(`[coin-ledger] acquireGas failed wallet=${wallet} minGas=${minGas}: ${e?.message || e}`);
+        }
+    }
+    async commit(wallet, changes) {
+        if (!changes.length)
+            return;
+        const client = await this.getClient();
+        await client.eval(lua_scripts_1.LUA_COMMIT, {
+            keys: [this.inflightKey(wallet)],
+            arguments: [this.base, this.gasBase, wallet, JSON.stringify(changes)],
+        });
+    }
+    async abort(wallet, txTag, consumed) {
+        const client = await this.getClient();
+        await client.eval(lua_scripts_1.LUA_ABORT, {
+            keys: [this.inflightKey(wallet)],
+            arguments: [this.base, this.gasBase, wallet, txTag, consumed ? '1' : '0'],
+        });
+    }
+    async reconcile(wallet, coinType, chainObjs, isGas = false) {
+        const client = await this.getClient();
+        const keys = isGas
+            ? [this.gasAvailKey(wallet), this.gasMetaKey(wallet), this.inflightKey(wallet)]
+            : [this.availKey(wallet, coinType), this.metaKey(wallet, coinType), this.inflightKey(wallet)];
+        const payload = chainObjs.map(o => ({ objectId: o.objectId, v: o.version, d: o.digest, b: o.balance }));
+        await client.eval(lua_scripts_1.LUA_RECONCILE, {
+            keys,
+            arguments: [JSON.stringify(payload), String(this.inflightTtlMs), String(Date.now())],
+        });
+        (0, dist_1.log_info)(`[coin-ledger] reconciled wallet=${wallet} ${isGas ? 'gas' : coinType} chainCoins=${chainObjs.length}`);
+    }
+    async availableCount(wallet, coinType, isGas = false) {
+        const client = await this.getClient();
+        const key = isGas ? this.gasAvailKey(wallet) : this.availKey(wallet, coinType);
+        return await client.zCard(key);
+    }
+}
+exports.WalletCoinLedger = WalletCoinLedger;

package/dist/trade/executor/central_executor.d.ts

@@ -0,0 +1,72 @@
+import { DEX_ID } from '@clonegod/ttd-core/dist';
+import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+import type { Experimental_SuiClientTypes } from '@mysten/sui/experimental';
+import { InProcessCoinCache } from './coin_cache';
+import { ExecutorCore } from './core_channel';
+export interface SwapExecRequest {
+    dexId: DEX_ID;
+    poolId: string;
+    coinTypeA: string;
+    coinTypeB: string;
+    a2b: boolean;
+    amountIn: bigint;
+    minOut: bigint;
+    sqrtPriceLimit: bigint;
+    walletAddress?: string;
+}
+export interface SwapExecResult {
+    digest: string;
+    success: boolean;
+    error?: string;
+}
+export interface SwapSubmitResult {
+    digest: string;
+    submitted: boolean;
+    error?: string;
+}
+export interface CentralExecutorOptions {
+    gasBudget?: bigint;
+    gasMinCoin?: bigint;
+    reconcileAfterTx?: boolean;
+    onBroadcastResult?: (r: {
+        digest: string;
+        success: boolean;
+        error?: string;
+    }) => void;
+}
+type TxResponse = Experimental_SuiClientTypes.TransactionResponse;
+export declare class CentralExecutor {
+    private readonly core;
+    private readonly cache;
+    private readonly gasBudget;
+    private readonly gasMinCoin;
+    private readonly reconcileAfterTx;
+    private readonly onBroadcastResult?;
+    private gasKeypair;
+    private gasAddress;
+    private tradeWallets;
+    private sharedRefCache;
+    private seq;
+    constructor(core: ExecutorCore, opts?: CentralExecutorOptions);
+    init(): Promise<void>;
+    reconcileCoins(wallet: string, coinType: string): Promise<void>;
+    private getSharedRefCached;
+    private getGasPrice;
+    private nextTag;
+    private inputCoinType;
+    private outputCoinType;
+    private chooseTradeWallet;
+    private registerShared;
+    submitSwap(req: SwapExecRequest): Promise<SwapSubmitResult>;
+    private broadcastAndCommit;
+    private reconcileAfterFailure;
+    simulateSwap(req: SwapExecRequest): Promise<TxResponse>;
+    private buildSwapTx;
+    private onSuccess;
+    get coinCache(): InProcessCoinCache;
+    get gasWalletAddress(): string;
+    get gasSigner(): Ed25519Keypair;
+    get tradeWalletAddresses(): string[];
+    get coreClient(): ExecutorCore;
+}
+export {};