forgex-cli 1.0.59 → 1.0.62
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +375 -368
- package/dist/bin/forgex.d.ts +5 -5
- package/dist/bin/forgex.js +14 -14
- package/dist/bin/forgex.js.map +1 -1
- package/dist/src/adapters/codex-adapter.d.ts +90 -90
- package/dist/src/adapters/codex-adapter.d.ts.map +1 -1
- package/dist/src/adapters/codex-adapter.js +76 -76
- package/dist/src/adapters/codex-adapter.js.map +1 -1
- package/dist/src/adapters/connection.d.ts +6 -6
- package/dist/src/adapters/connection.js +8 -8
- package/dist/src/adapters/connection.js.map +1 -1
- package/dist/src/adapters/ipfs.d.ts +3 -3
- package/dist/src/adapters/ipfs.js +3 -3
- package/dist/src/adapters/jito-adapter.d.ts +85 -85
- package/dist/src/adapters/jito-adapter.d.ts.map +1 -1
- package/dist/src/adapters/jito-adapter.js +111 -111
- package/dist/src/adapters/jito-adapter.js.map +1 -1
- package/dist/src/adapters/rpc-adapter.d.ts +53 -53
- package/dist/src/adapters/rpc-adapter.d.ts.map +1 -1
- package/dist/src/adapters/rpc-adapter.js +69 -69
- package/dist/src/adapters/rpc-adapter.js.map +1 -1
- package/dist/src/adapters/sdk-adapter.d.ts +21 -21
- package/dist/src/adapters/sdk-adapter.d.ts.map +1 -1
- package/dist/src/adapters/sdk-adapter.js +79 -79
- package/dist/src/adapters/sdk-adapter.js.map +1 -1
- package/dist/src/commands/config/index.d.ts +1 -1
- package/dist/src/commands/config/index.js +15 -15
- package/dist/src/commands/config/index.js.map +1 -1
- package/dist/src/commands/query/index.d.ts +2 -2
- package/dist/src/commands/query/index.js +82 -82
- package/dist/src/commands/query/index.js.map +1 -1
- package/dist/src/commands/token/index.d.ts +8 -8
- package/dist/src/commands/token/index.js +73 -73
- package/dist/src/commands/token/index.js.map +1 -1
- package/dist/src/commands/tools/index.d.ts +9 -9
- package/dist/src/commands/tools/index.js +137 -137
- package/dist/src/commands/tools/index.js.map +1 -1
- package/dist/src/commands/trade/index.d.ts +2 -2
- package/dist/src/commands/trade/index.d.ts.map +1 -1
- package/dist/src/commands/trade/index.js +120 -82
- package/dist/src/commands/trade/index.js.map +1 -1
- package/dist/src/commands/transfer/index.d.ts +8 -8
- package/dist/src/commands/transfer/index.js +106 -106
- package/dist/src/commands/transfer/index.js.map +1 -1
- package/dist/src/commands/wallet/index.d.ts +1 -1
- package/dist/src/commands/wallet/index.js +175 -175
- package/dist/src/commands/wallet/index.js.map +1 -1
- package/dist/src/config.d.ts +26 -26
- package/dist/src/config.d.ts.map +1 -1
- package/dist/src/config.js +28 -28
- package/dist/src/config.js.map +1 -1
- package/dist/src/const/index.js +1 -1
- package/dist/src/const/index.js.map +1 -1
- package/dist/src/data-source.d.ts +81 -81
- package/dist/src/data-source.d.ts.map +1 -1
- package/dist/src/data-source.js +149 -149
- package/dist/src/data-source.js.map +1 -1
- package/dist/src/data-store/index.d.ts +22 -22
- package/dist/src/data-store/index.d.ts.map +1 -1
- package/dist/src/data-store/index.js +46 -46
- package/dist/src/data-store/index.js.map +1 -1
- package/dist/src/data-store/types.d.ts +3 -3
- package/dist/src/data-store/types.js +3 -3
- package/dist/src/index.d.ts +2 -2
- package/dist/src/index.js +10 -10
- package/dist/src/index.js.map +1 -1
- package/dist/src/output.d.ts +18 -18
- package/dist/src/output.d.ts.map +1 -1
- package/dist/src/output.js +34 -34
- package/dist/src/output.js.map +1 -1
- package/dist/src/shims/store.d.ts +3 -2
- package/dist/src/shims/store.d.ts.map +1 -1
- package/dist/src/shims/store.js +6 -5
- package/dist/src/shims/store.js.map +1 -1
- package/dist/src/sol-sdk/batch/create.d.ts +4 -1
- package/dist/src/sol-sdk/batch/create.d.ts.map +1 -1
- package/dist/src/sol-sdk/batch/create.js +44 -44
- package/dist/src/sol-sdk/batch/create.js.map +1 -1
- package/dist/src/sol-sdk/batch/index.js +135 -135
- package/dist/src/sol-sdk/batch/index.js.map +1 -1
- package/dist/src/sol-sdk/calc.d.ts +63 -63
- package/dist/src/sol-sdk/calc.d.ts.map +1 -1
- package/dist/src/sol-sdk/calc.js +120 -120
- package/dist/src/sol-sdk/calc.js.map +1 -1
- package/dist/src/sol-sdk/jito/index.js +12 -12
- package/dist/src/sol-sdk/jito/index.js.map +1 -1
- package/dist/src/sol-sdk/launchlab/instructions/create.js +10 -10
- package/dist/src/sol-sdk/launchlab/instructions/create.js.map +1 -1
- package/dist/src/sol-sdk/meteora/index.d.ts +5 -5
- package/dist/src/sol-sdk/meteora/index.js +11 -11
- package/dist/src/sol-sdk/meteora/index.js.map +1 -1
- package/dist/src/sol-sdk/meteora/instructions/buy.js +8 -8
- package/dist/src/sol-sdk/meteora/instructions/buy.js.map +1 -1
- package/dist/src/sol-sdk/meteora/instructions/sell.js +6 -6
- package/dist/src/sol-sdk/meteora/instructions/sell.js.map +1 -1
- package/dist/src/sol-sdk/pump/index.js +3 -3
- package/dist/src/sol-sdk/pump/index.js.map +1 -1
- package/dist/src/sol-sdk/pump/instructions/buy.d.ts +12 -12
- package/dist/src/sol-sdk/pump/instructions/buy.d.ts.map +1 -1
- package/dist/src/sol-sdk/pump/instructions/buy.js +26 -26
- package/dist/src/sol-sdk/pump/instructions/buy.js.map +1 -1
- package/dist/src/sol-sdk/pump/instructions/createAndBuy.d.ts +13 -13
- package/dist/src/sol-sdk/pump/instructions/createAndBuy.js +17 -17
- package/dist/src/sol-sdk/pump/instructions/createAndBuy.js.map +1 -1
- package/dist/src/sol-sdk/pump/instructions/sell.d.ts +2 -2
- package/dist/src/sol-sdk/pump/instructions/sell.d.ts.map +1 -1
- package/dist/src/sol-sdk/pump/instructions/sell.js +7 -7
- package/dist/src/sol-sdk/pump/instructions/sell.js.map +1 -1
- package/dist/src/sol-sdk/pumpswap/index.d.ts +4 -4
- package/dist/src/sol-sdk/pumpswap/index.js +5 -5
- package/dist/src/sol-sdk/pumpswap/index.js.map +1 -1
- package/dist/src/sol-sdk/pumpswap/instructions/buy.d.ts +8 -8
- package/dist/src/sol-sdk/pumpswap/instructions/buy.js +19 -19
- package/dist/src/sol-sdk/pumpswap/instructions/buy.js.map +1 -1
- package/dist/src/sol-sdk/pumpswap/instructions/migrate.js +2 -2
- package/dist/src/sol-sdk/pumpswap/instructions/migrate.js.map +1 -1
- package/dist/src/sol-sdk/pumpswap/instructions/sell.js +4 -4
- package/dist/src/sol-sdk/pumpswap/instructions/sell.js.map +1 -1
- package/dist/src/sol-sdk/pumpswap/rpc/index.js +1 -1
- package/dist/src/sol-sdk/pumpswap/rpc/index.js.map +1 -1
- package/dist/src/sol-sdk/raydium/instructions/cpmmSell.js +3 -3
- package/dist/src/sol-sdk/raydium/instructions/cpmmSell.js.map +1 -1
- package/dist/src/sol-sdk/raydium/instructions/sell.d.ts +40 -8520
- package/dist/src/sol-sdk/raydium/instructions/sell.d.ts.map +1 -1
- package/dist/src/sol-sdk/raydium/instructions/sell.js +6 -6
- package/dist/src/sol-sdk/raydium/instructions/sell.js.map +1 -1
- package/dist/src/sol-sdk/raydium/rpc/index.d.ts +4 -4
- package/dist/src/sol-sdk/rpc/index.d.ts +14 -14
- package/dist/src/sol-sdk/rpc/index.d.ts.map +1 -1
- package/dist/src/sol-sdk/rpc/index.js +17 -17
- package/dist/src/sol-sdk/rpc/index.js.map +1 -1
- package/dist/src/sol-sdk/transfer/index.js +5 -5
- package/dist/src/sol-sdk/transfer/index.js.map +1 -1
- package/dist/src/sol-sdk/turnover/index.d.ts +3 -3
- package/dist/src/sol-sdk/turnover/index.js +56 -56
- package/dist/src/sol-sdk/turnover/index.js.map +1 -1
- package/dist/src/telemetry.d.ts +8 -8
- package/dist/src/telemetry.d.ts.map +1 -1
- package/dist/src/telemetry.js +25 -25
- package/dist/src/telemetry.js.map +1 -1
- package/dist/src/tx-tracker/detail-adapter.d.ts +53 -53
- package/dist/src/tx-tracker/detail-adapter.d.ts.map +1 -1
- package/dist/src/tx-tracker/detail-adapter.js +68 -68
- package/dist/src/tx-tracker/detail-adapter.js.map +1 -1
- package/dist/src/tx-tracker/index.d.ts +67 -67
- package/dist/src/tx-tracker/index.d.ts.map +1 -1
- package/dist/src/tx-tracker/index.js +103 -103
- package/dist/src/tx-tracker/index.js.map +1 -1
- package/dist/src/types/index.d.ts +10 -10
- package/dist/src/types/index.d.ts.map +1 -1
- package/dist/src/types/websocket.js +1 -1
- package/dist/src/types/websocket.js.map +1 -1
- package/dist/src/utils/index.js +20 -20
- package/dist/src/utils/index.js.map +1 -1
- package/dist/src/wallet-store.d.ts +51 -51
- package/dist/src/wallet-store.d.ts.map +1 -1
- package/dist/src/wallet-store.js +104 -104
- package/dist/src/wallet-store.js.map +1 -1
- package/package.json +1 -1
|
@@ -1,24 +1,24 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* ForgeX CLI DataSource --
|
|
2
|
+
* ForgeX CLI DataSource -- Unified Data Source Facade
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
* JitoAdapter
|
|
4
|
+
* Single data access interface for the command layer. Wraps all data adapters (CodexAdapter, RpcAdapter,
|
|
5
|
+
* JitoAdapter, DataStore) into a unified facade with simple interfaces for command use.
|
|
6
6
|
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
* Bundle
|
|
11
|
-
*
|
|
7
|
+
* Routing logic:
|
|
8
|
+
* Token info / price / candlestick / pool info --> CodexAdapter (remote, cache-through to DataStore)
|
|
9
|
+
* Balance / account info / tx confirmation --> RpcAdapter (on-chain)
|
|
10
|
+
* Bundle send / status query --> JitoAdapter (Jito Block Engine)
|
|
11
|
+
* Trade records / positions / wallet group data --> DataStore (local files)
|
|
12
12
|
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
13
|
+
* Cache-through:
|
|
14
|
+
* Reads DataStore local cache first. On miss or expiry, fetches from remote (Codex/RPC),
|
|
15
|
+
* writes to DataStore, then returns.
|
|
16
16
|
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
* RPC/Jito
|
|
17
|
+
* Fault tolerance:
|
|
18
|
+
* When Codex API is unavailable, falls back to historical cache in DataStore.
|
|
19
|
+
* When RPC/Jito unavailable, throws DataSourceError for command layer to handle.
|
|
20
20
|
*
|
|
21
|
-
*
|
|
21
|
+
* Design reference: ARCH-DESIGN-v2.md Section 2.7
|
|
22
22
|
*/
|
|
23
23
|
import { CodexAdapter } from './adapters/codex-adapter.js';
|
|
24
24
|
import { RpcAdapter } from './adapters/rpc-adapter.js';
|
|
@@ -33,11 +33,11 @@ import type { TokenInfoFile, PoolInfoFile, TransactionsFile, TransactionRecord,
|
|
|
33
33
|
import type { TrackingContext, TrackingOptions, TrackingResult } from './tx-tracker/index.js';
|
|
34
34
|
export type { TokenInfoFile, PoolInfoFile, TransactionsFile, TransactionRecord, HoldingsFile, WalletHolding, BalancesFile, WalletBalance, FeeConfigFile, CodexTokenMarketData, CodexBar, GetBarsParams, CodexPairInfo, TokenAccountInfo, TransactionStatus, ParsedTransactionDetail, BundleStatusResult, BundleConfirmationResult, WaitOptions, BundleStatusEnum, TrackingContext, TrackingOptions, TrackingResult, };
|
|
35
35
|
export declare class DataSourceError extends Error {
|
|
36
|
-
/**
|
|
36
|
+
/** Error source */
|
|
37
37
|
readonly source: 'codex' | 'rpc' | 'jito' | 'store' | 'unknown';
|
|
38
|
-
/**
|
|
38
|
+
/** Whether fallback to cache was used */
|
|
39
39
|
readonly fellBackToCache: boolean;
|
|
40
|
-
/**
|
|
40
|
+
/** Original error */
|
|
41
41
|
readonly cause?: Error;
|
|
42
42
|
constructor(message: string, source: DataSourceError['source'], options?: {
|
|
43
43
|
fellBackToCache?: boolean;
|
|
@@ -58,178 +58,178 @@ export declare class DataSource {
|
|
|
58
58
|
tracker?: TxTracker;
|
|
59
59
|
});
|
|
60
60
|
/**
|
|
61
|
-
*
|
|
61
|
+
* Get basic token info.
|
|
62
62
|
*
|
|
63
|
-
*
|
|
64
|
-
* 1.
|
|
65
|
-
* 2.
|
|
66
|
-
* 3.
|
|
67
|
-
* 4. Codex
|
|
63
|
+
* Flow:
|
|
64
|
+
* 1. Check DataStore cache first
|
|
65
|
+
* 2. Cache hit and not expired -> return directly
|
|
66
|
+
* 3. Cache miss or expired -> fetch from Codex and write to DataStore
|
|
67
|
+
* 4. Codex unavailable -> fallback to stale DataStore cache (if any)
|
|
68
68
|
*/
|
|
69
69
|
getTokenInfo(ca: string): Promise<TokenInfoFile>;
|
|
70
70
|
/**
|
|
71
|
-
*
|
|
72
|
-
*
|
|
71
|
+
* Get detailed token market data (including price, volume, holders, etc).
|
|
72
|
+
* Fetches directly from Codex without local cache-through (market data requires high timeliness).
|
|
73
73
|
*/
|
|
74
74
|
getTokenMarketData(ca: string): Promise<CodexTokenMarketData>;
|
|
75
75
|
/**
|
|
76
|
-
*
|
|
76
|
+
* Get token price (SOL and USD).
|
|
77
77
|
*
|
|
78
|
-
*
|
|
78
|
+
* Cache-through: checks DataStore pool-info cached price first, fetches from Codex if expired.
|
|
79
79
|
*/
|
|
80
80
|
getTokenPrice(ca: string): Promise<{
|
|
81
81
|
priceSol: number;
|
|
82
82
|
priceUsd: number;
|
|
83
83
|
}>;
|
|
84
84
|
/**
|
|
85
|
-
*
|
|
85
|
+
* Get SOL price (USD).
|
|
86
86
|
*
|
|
87
|
-
*
|
|
87
|
+
* Cache-through: checks DataStore first, fetches from Codex and updates if expired.
|
|
88
88
|
*/
|
|
89
89
|
getSolPrice(): Promise<number>;
|
|
90
90
|
/**
|
|
91
|
-
*
|
|
91
|
+
* Get liquidity pool info.
|
|
92
92
|
*
|
|
93
|
-
*
|
|
93
|
+
* Cache-through: DataStore valid -> return; miss/expired -> fetch from Codex and write.
|
|
94
94
|
*/
|
|
95
95
|
getPoolInfo(ca: string): Promise<PoolInfoFile>;
|
|
96
96
|
/**
|
|
97
|
-
*
|
|
98
|
-
*
|
|
97
|
+
* Get candlestick (OHLCV) data.
|
|
98
|
+
* Candlestick data is large and time-sensitive, no local caching.
|
|
99
99
|
*/
|
|
100
100
|
getKlineData(params: GetBarsParams): Promise<CodexBar[]>;
|
|
101
101
|
/**
|
|
102
|
-
*
|
|
102
|
+
* Get trading pair list for a token.
|
|
103
103
|
*/
|
|
104
104
|
getPairsForToken(ca: string, limit?: number): Promise<CodexPairInfo[]>;
|
|
105
105
|
/**
|
|
106
|
-
*
|
|
106
|
+
* Get SOL balance for a single wallet.
|
|
107
107
|
*/
|
|
108
108
|
getSolBalance(address: string): Promise<number>;
|
|
109
109
|
/**
|
|
110
|
-
*
|
|
110
|
+
* Batch get SOL balances for multiple wallets.
|
|
111
111
|
*/
|
|
112
112
|
getBatchSolBalances(addresses: string[]): Promise<Record<string, number>>;
|
|
113
113
|
/**
|
|
114
|
-
*
|
|
114
|
+
* Get single token balance for a wallet.
|
|
115
115
|
*/
|
|
116
116
|
getTokenBalance(walletAddress: string, tokenMint: string): Promise<number>;
|
|
117
117
|
/**
|
|
118
|
-
*
|
|
118
|
+
* Batch get token balances for multiple wallets on a specific token.
|
|
119
119
|
*/
|
|
120
120
|
getBatchTokenBalances(walletAddresses: string[], tokenMint: string): Promise<Record<string, number>>;
|
|
121
121
|
/**
|
|
122
|
-
*
|
|
122
|
+
* Get all token accounts for a single wallet.
|
|
123
123
|
*/
|
|
124
124
|
getTokenAccountsByOwner(walletAddress: string): Promise<TokenAccountInfo[]>;
|
|
125
125
|
/**
|
|
126
|
-
*
|
|
126
|
+
* Get complete balance data for wallet group on a specific token.
|
|
127
127
|
*
|
|
128
|
-
*
|
|
128
|
+
* Fetches from RPC in real-time, updates DataStore, then returns BalancesFile.
|
|
129
129
|
*/
|
|
130
130
|
getWalletBalances(walletAddresses: string[], ca: string, groupId: number): Promise<BalancesFile>;
|
|
131
131
|
/**
|
|
132
|
-
*
|
|
132
|
+
* Query confirmation status of a single transaction.
|
|
133
133
|
*/
|
|
134
134
|
getTransactionStatus(txHash: string): Promise<TransactionStatus>;
|
|
135
135
|
/**
|
|
136
|
-
*
|
|
136
|
+
* Get transaction details.
|
|
137
137
|
*/
|
|
138
138
|
getTransactionDetail(txHash: string): Promise<ParsedTransactionDetail | null>;
|
|
139
139
|
/**
|
|
140
|
-
*
|
|
140
|
+
* Batch query transaction statuses.
|
|
141
141
|
*/
|
|
142
142
|
getBatchTransactionStatuses(txHashes: string[]): Promise<Record<string, TransactionStatus>>;
|
|
143
143
|
/**
|
|
144
|
-
*
|
|
144
|
+
* Send bundle to Jito Block Engine.
|
|
145
145
|
*/
|
|
146
146
|
sendBundle(base64Txs: string[]): Promise<{
|
|
147
147
|
bundleId: string;
|
|
148
148
|
}>;
|
|
149
149
|
/**
|
|
150
|
-
*
|
|
150
|
+
* Query bundle status.
|
|
151
151
|
*/
|
|
152
152
|
getBundleStatus(bundleId: string): Promise<BundleStatusResult>;
|
|
153
153
|
/**
|
|
154
|
-
*
|
|
154
|
+
* Wait for bundle confirmation.
|
|
155
155
|
*/
|
|
156
156
|
waitForBundleConfirmation(bundleId: string, options?: WaitOptions): Promise<BundleConfirmationResult>;
|
|
157
157
|
/**
|
|
158
|
-
*
|
|
158
|
+
* Send single transaction via Jito.
|
|
159
159
|
*/
|
|
160
160
|
sendTransaction(base64Tx: string): Promise<{
|
|
161
161
|
txHash: string;
|
|
162
162
|
}>;
|
|
163
163
|
/**
|
|
164
|
-
*
|
|
164
|
+
* Confirm transaction status via RPC.
|
|
165
165
|
*/
|
|
166
166
|
confirmTransactionByRpc(connection: Connection, signature: string, timeoutMs?: number): Promise<{
|
|
167
167
|
success: boolean;
|
|
168
168
|
error?: string;
|
|
169
169
|
}>;
|
|
170
170
|
/**
|
|
171
|
-
*
|
|
171
|
+
* Get trade records.
|
|
172
172
|
*/
|
|
173
173
|
getTransactions(ca: string, groupId: number): TransactionsFile | null;
|
|
174
174
|
/**
|
|
175
|
-
*
|
|
175
|
+
* Get trade records for a specific wallet.
|
|
176
176
|
*/
|
|
177
177
|
getTransactionsByWallet(ca: string, groupId: number, wallet: string): TransactionRecord[];
|
|
178
178
|
/**
|
|
179
|
-
*
|
|
179
|
+
* Append trade records.
|
|
180
180
|
*/
|
|
181
181
|
appendTransaction(ca: string, groupId: number, tx: TransactionRecord): Promise<void>;
|
|
182
182
|
/**
|
|
183
|
-
*
|
|
183
|
+
* Get position data.
|
|
184
184
|
*/
|
|
185
185
|
getHoldings(ca: string, groupId: number): HoldingsFile | null;
|
|
186
186
|
/**
|
|
187
|
-
*
|
|
187
|
+
* Update position data.
|
|
188
188
|
*/
|
|
189
189
|
updateHolding(ca: string, groupId: number, wallet: string, update: Partial<WalletHolding>): Promise<void>;
|
|
190
190
|
/**
|
|
191
|
-
*
|
|
191
|
+
* Get locally cached balance snapshot.
|
|
192
192
|
*/
|
|
193
193
|
getBalancesSnapshot(ca: string, groupId: number): BalancesFile | null;
|
|
194
194
|
/**
|
|
195
|
-
*
|
|
195
|
+
* Update balance snapshot.
|
|
196
196
|
*/
|
|
197
197
|
updateBalance(ca: string, groupId: number, wallet: string, balance: WalletBalance): Promise<void>;
|
|
198
198
|
/**
|
|
199
|
-
*
|
|
199
|
+
* Get fee configuration.
|
|
200
200
|
*/
|
|
201
201
|
getFeeConfig(): FeeConfigFile | null;
|
|
202
202
|
/**
|
|
203
|
-
*
|
|
203
|
+
* Save fee configuration.
|
|
204
204
|
*/
|
|
205
205
|
saveFeeConfig(config: FeeConfigFile): Promise<void>;
|
|
206
206
|
/**
|
|
207
|
-
*
|
|
207
|
+
* List all token CAs with data.
|
|
208
208
|
*/
|
|
209
209
|
listTokens(): string[];
|
|
210
210
|
/**
|
|
211
|
-
*
|
|
211
|
+
* List all wallet group IDs with data for a token.
|
|
212
212
|
*/
|
|
213
213
|
listGroups(ca: string): number[];
|
|
214
214
|
/**
|
|
215
|
-
*
|
|
216
|
-
*
|
|
215
|
+
* Track a single transaction.
|
|
216
|
+
* Auto-writes to DataStore after polling confirmation (trade records + positions + balances).
|
|
217
217
|
*/
|
|
218
218
|
trackTransaction(txHash: string, context: TrackingContext, options?: TrackingOptions): Promise<TrackingResult>;
|
|
219
219
|
/**
|
|
220
|
-
*
|
|
221
|
-
*
|
|
220
|
+
* Track a Jito Bundle.
|
|
221
|
+
* Processes internal transactions individually after bundle confirmation and writes to DataStore.
|
|
222
222
|
*/
|
|
223
223
|
trackBundle(bundleId: string, txHashes: string[], context: TrackingContext, options?: TrackingOptions): Promise<TrackingResult[]>;
|
|
224
224
|
/**
|
|
225
|
-
*
|
|
225
|
+
* Batch track multiple independent transactions.
|
|
226
226
|
*/
|
|
227
227
|
trackBatch(entries: Array<{
|
|
228
228
|
txHash: string;
|
|
229
229
|
context: TrackingContext;
|
|
230
230
|
}>, options?: TrackingOptions): Promise<TrackingResult[]>;
|
|
231
231
|
/**
|
|
232
|
-
*
|
|
232
|
+
* Check health status of all data sources.
|
|
233
233
|
*/
|
|
234
234
|
healthCheck(): Promise<{
|
|
235
235
|
codex: {
|
|
@@ -247,38 +247,38 @@ export declare class DataSource {
|
|
|
247
247
|
error?: string;
|
|
248
248
|
};
|
|
249
249
|
}>;
|
|
250
|
-
/**
|
|
250
|
+
/** Get underlying CodexAdapter (only when DataSource interface is insufficient) */
|
|
251
251
|
getCodexAdapter(): CodexAdapter;
|
|
252
|
-
/**
|
|
252
|
+
/** Get underlying RpcAdapter */
|
|
253
253
|
getRpcAdapter(): RpcAdapter;
|
|
254
|
-
/**
|
|
254
|
+
/** Get underlying JitoAdapter */
|
|
255
255
|
getJitoAdapter(): JitoAdapter;
|
|
256
|
-
/**
|
|
256
|
+
/** Get underlying DataStore */
|
|
257
257
|
getDataStore(): DataStore;
|
|
258
|
-
/**
|
|
258
|
+
/** Get underlying TxTracker */
|
|
259
259
|
getTxTracker(): TxTracker;
|
|
260
260
|
/**
|
|
261
|
-
*
|
|
262
|
-
* @param updatedAt
|
|
263
|
-
* @param ttlMs
|
|
264
|
-
* @returns true
|
|
261
|
+
* Check if timestamp has expired.
|
|
262
|
+
* @param updatedAt Last update time (ms)
|
|
263
|
+
* @param ttlMs Time-to-live (ms)
|
|
264
|
+
* @returns true if expired
|
|
265
265
|
*/
|
|
266
266
|
private isExpired;
|
|
267
267
|
/**
|
|
268
|
-
*
|
|
269
|
-
* Codex API
|
|
268
|
+
* Infer DEX type from DEX/exchange name.
|
|
269
|
+
* Maps Codex API exchangeName to TokenInfoFile.dex enum.
|
|
270
270
|
*/
|
|
271
271
|
private inferDex;
|
|
272
272
|
}
|
|
273
273
|
/**
|
|
274
|
-
*
|
|
275
|
-
*
|
|
274
|
+
* Get DataSource global singleton.
|
|
275
|
+
* Standard entry point for command layer:
|
|
276
276
|
* import { getDataSource } from '../data-source.js';
|
|
277
277
|
* const ds = getDataSource();
|
|
278
278
|
*/
|
|
279
279
|
export declare function getDataSource(): DataSource;
|
|
280
280
|
/**
|
|
281
|
-
*
|
|
281
|
+
* Reset singleton (for testing or re-initialization after config changes).
|
|
282
282
|
*/
|
|
283
283
|
export declare function resetDataSource(): void;
|
|
284
284
|
//# sourceMappingURL=data-source.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../../src/data-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,YAAY,EAAmB,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAiB,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAkB,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAgB,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAgB,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAChH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC9G,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9H,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG9F,YAAY,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,QAAQ,EACR,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,GACf,CAAC;AAMF,qBAAa,eAAgB,SAAQ,KAAK;IACxC,
|
|
1
|
+
{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../../src/data-source.ts"],"names":[],"mappings":"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"}
|