@symbiosis-finance/sdk-tracker 0.0.2

package/README.md

@@ -0,0 +1,14 @@
+# @symbiosis/sdk-tracker
+
+On-chain **cross-chain transaction tracking** for Symbiosis: given a source transaction, its waiters watch the relevant chains (EVM, TON, BTC, Tron, ChainFlip, ThorChain) until the cross-chain operation completes.
+
+Unlike `@symbiosis/sdk-types` (web3-light), this package **does** depend on heavy chain libraries (`ethers`, `tronweb`, `@ton/*`, `@chainflip/sdk`), so the client should **lazy-load it** via dynamic `import()` to keep those out of the initial bundle.
+
+## Layout (`src/`)
+
+- **`waitForComplete/`** — the public waiters: `waitForComplete` plus per-rail trackers (`waitForChainFlipSwap`, `waitForThorChainTx`, `waitForBtcDepositAccepted`, `waitFromTonTxMined`, `waitForIntentSolved`, `waitForDepositUnlocked`, …) and their result types.
+- **`contracts/`** — TypeChain bindings & factories (`Bridge`, `Portal`, `Synthesis`, `IDepository`, `SymBtc`, intents) used to read on-chain state.
+- **`chainUtils/`** — low-level chain helpers (`evm`, `tron`).
+- **`api/`** — external status API clients (ThorChain).
+- **`TrackerContext.ts`** — the structural interface the waiters run against (providers, configs, contract factories), keeping the package decoupled from the app/API's `Symbiosis` class — the consumer wires it up.
+- **`index.ts`** — public barrel.

package/dist/esm/TrackerContext.d.ts

@@ -0,0 +1,33 @@
+import type { StaticJsonRpcProvider } from '@ethersproject/providers';
+import type { TonClient4 } from '@ton/ton';
+import type { BtcConfig, ChainConfig, ChainId, Config, Token } from '@symbiosis-finance/sdk-types';
+import type { Bridge, IDepository, Portal, Synthesis } from './contracts/index.js';
+/**
+ * The minimal context the on-chain tracking waiters require from their host.
+ */
+export interface TrackerContext {
+    /** Full SDK config (waiters read `config.chains`). */
+    readonly config: Config;
+    /** Returns a JSON-RPC provider for the given chain (optionally pinned to a spare rpc). */
+    getProvider(chainId: ChainId, rpc?: string): StaticJsonRpcProvider;
+    /** Returns the starting block (with the chain's configured offset) to scan logs from. */
+    getFromBlockWithOffset(chainId: ChainId): Promise<number>;
+    /** Returns a TON client. */
+    getTonClient(): Promise<TonClient4>;
+    /** Returns the chain config for the given chain. */
+    chainConfig(chainId: ChainId): ChainConfig;
+    /** Returns the BTC config for the given BTC token. */
+    getBtcConfig(btc: Token): BtcConfig;
+    /** Returns all known tokens. */
+    tokens(): Token[];
+    /** Portal contract bound to the given chain. */
+    portal(chainId: ChainId): Portal;
+    /** Synthesis contract bound to the given chain. */
+    synthesis(chainId: ChainId): Synthesis;
+    /** Bridge contract bound to the given chain. */
+    bridge(chainId: ChainId): Bridge;
+    /** Depository context for the given chain, or null if not configured. */
+    depository(chainId: ChainId): Promise<{
+        depository: IDepository;
+    } | null>;
+}

package/dist/esm/TrackerContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TrackerContext.js.map

package/dist/esm/TrackerContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackerContext.js","sourceRoot":"","sources":["../../src/TrackerContext.ts"],"names":[],"mappings":""}

package/dist/esm/api/thorchain.d.ts

@@ -0,0 +1,3 @@
+import { Api } from './thorchain.generated.js';
+export * from './thorchain.generated.js';
+export declare const thorchainApi: Api<unknown>;