@kaleidorg/wallet-engine 1.0.0-beta.37 → 1.0.0-beta.38

package/dist/adapters/flashnet.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Flashnet adapter entry — AMM (Flashnet) + cross-chain bridge (Orchestra).
+ *
+ * Opt-in sub-path export: `@kaleidorg/wallet-engine/adapters/flashnet`. Pulls
+ * `@flashnet/sdk` (via the Flashnet client manager) — not the Arkade/RGB SDKs.
+ * The Orchestra REST client carries no SDK; its API key is consumer-injected
+ * via `setOrchestraApiKey()` (kept out of the engine, which has no build-time env).
+ *
+ * `flashnetClientManager.initialize()` needs a `SparkWallet`, so this composes
+ * with `@kaleidorg/wallet-engine/adapters/spark`.
+ */
+export { flashnetClientManager } from '../lib/flashnet-client-manager.js';
+export * from '../lib/orchestra-client.js';
+//# sourceMappingURL=flashnet.d.ts.map

package/dist/adapters/flashnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flashnet.d.ts","sourceRoot":"","sources":["../../src/adapters/flashnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,cAAc,yBAAyB,CAAA"}

package/dist/adapters/flashnet.js

@@ -0,0 +1,14 @@
+/**
+ * Flashnet adapter entry — AMM (Flashnet) + cross-chain bridge (Orchestra).
+ *
+ * Opt-in sub-path export: `@kaleidorg/wallet-engine/adapters/flashnet`. Pulls
+ * `@flashnet/sdk` (via the Flashnet client manager) — not the Arkade/RGB SDKs.
+ * The Orchestra REST client carries no SDK; its API key is consumer-injected
+ * via `setOrchestraApiKey()` (kept out of the engine, which has no build-time env).
+ *
+ * `flashnetClientManager.initialize()` needs a `SparkWallet`, so this composes
+ * with `@kaleidorg/wallet-engine/adapters/spark`.
+ */
+export { flashnetClientManager } from '../lib/flashnet-client-manager.js';
+export * from '../lib/orchestra-client.js';
+//# sourceMappingURL=flashnet.js.map

package/dist/adapters/flashnet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flashnet.js","sourceRoot":"","sources":["../../src/adapters/flashnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,cAAc,yBAAyB,CAAA"}

package/dist/lib/flashnet-client-manager.d.ts

@@ -1,23 +1,40 @@
 /**
  * Flashnet Client Manager
- * Manages the lifecycle of a FlashnetClient from @flashnet/sdk.
+ * Singleton managing the lifecycle of a FlashnetClient from `@flashnet/sdk`.
  * Requires an initialized SparkWallet to function.
- * Ported from rate-extension/src/lib/flashnet-client-manager.ts
+ *
+ * Ported from rate-extension/src/protocols/spark/flashnet-client-manager.ts.
+ * The SDK is a value import (optional dependency) — consumers install
+ * `@flashnet/sdk` to use this manager, matching the Spark client-manager convention.
  */
+import type { SparkWallet } from '@buildonspark/spark-sdk';
+import { FlashnetClient, type WalletBalance } from '@flashnet/sdk';
 import { type FlashnetNetwork } from '../types/flashnet.js';
+import type { SparkConfig } from '../types/spark.js';
 declare class FlashnetClientManager {
     private client;
     private initPromise;
     private poolId;
     private network;
+    initialize(wallet: SparkWallet, sparkNetwork?: SparkConfig['network']): Promise<void>;
+    private doInitialize;
     /**
-     * Initialize with a SparkWallet instance.
-     * @param wallet - SparkWallet from @buildonspark/spark-sdk
-     * @param sparkNetwork - The Spark network ('mainnet' | 'regtest')
+     * Fetch the wallet's AMM swap history and persist the outgoing (token-in)
+     * legs to the sent-token outbox.
+     *
+     * A swap moves a token to the pool via an internal SDK transfer that the
+     * Spark token-transaction query cannot classify as a send. Flashnet's
+     * `GET /v1/swaps/user/{pubkey}` returns every past swap with explicit
+     * direction (assetIn / amountIn / inboundTransferId), so this both fixes
+     * future swaps and recovers ones made before any recording existed.
+     *
+     * Idempotent — records are keyed by transfer hash, so re-running on each
+     * connect simply refreshes them.
      */
-    initialize(wallet: any, sparkNetwork?: string): Promise<void>;
-    private doInitialize;
-    getClient(): any;
+    private backfillSwapHistory;
+    getClient(): FlashnetClient;
+    /** Convenience pass-through so callers don't need to await client.getBalance() through a cast. */
+    getBalance(): Promise<WalletBalance>;
     getPoolId(): string | null;
     getNetwork(): FlashnetNetwork | null;
     getUsdbTokenAddress(): string;

package/dist/lib/flashnet-client-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flashnet-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/flashnet-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAkB1B,cAAM,qBAAqB;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAA+B;IAE9C;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ/C,YAAY;IAuC1B,SAAS,IAAI,GAAG;IAOhB,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,UAAU,IAAI,eAAe,GAAG,IAAI;IAIpC,mBAAmB,IAAI,MAAM;IAO7B,aAAa,IAAI,OAAO;IAIlB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAalC;AAED,eAAO,MAAM,qBAAqB,uBAA8B,CAAA"}
+{"version":3,"file":"flashnet-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/flashnet-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAkBjD,cAAM,qBAAqB;IACzB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAA+B;IAE9C,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAQvE,YAAY;IAqD1B;;;;;;;;;;;;OAYG;YACW,mBAAmB;IA4DjC,SAAS,IAAI,cAAc;IAO3B,kGAAkG;IAC5F,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC;IAI1C,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,UAAU,IAAI,eAAe,GAAG,IAAI;IAIpC,mBAAmB,IAAI,MAAM;IAO7B,aAAa,IAAI,OAAO;IAIlB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAalC;AAED,eAAO,MAAM,qBAAqB,uBAA8B,CAAA"}

package/dist/lib/flashnet-client-manager.js

@@ -1,10 +1,16 @@
 /**
  * Flashnet Client Manager
- * Manages the lifecycle of a FlashnetClient from @flashnet/sdk.
+ * Singleton managing the lifecycle of a FlashnetClient from `@flashnet/sdk`.
  * Requires an initialized SparkWallet to function.
- * Ported from rate-extension/src/lib/flashnet-client-manager.ts
+ *
+ * Ported from rate-extension/src/protocols/spark/flashnet-client-manager.ts.
+ * The SDK is a value import (optional dependency) — consumers install
+ * `@flashnet/sdk` to use this manager, matching the Spark client-manager convention.
  */
-import { BTC_ASSET_PUBKEY, getFlashnetNetworkForSpark, getFlashnetUsdbTokenAddress, } from '../types/flashnet.js';
+import { FlashnetClient } from '@flashnet/sdk';
+import { BTC_ASSET_PUBKEY, USDB_DECIMALS, getFlashnetNetworkForSpark, getFlashnetUsdbTokenAddress, isUsdbTokenAddress, } from '../types/flashnet.js';
+import { log } from './log.js';
+import { saveSentTokenRecord } from './spark-sent-token-records.js';
 /**
  * Normalize the SDK pools response to always return an array.
  * The SDK may return `Pool[]` or `{ pools: Pool[] }`.
@@ -26,11 +32,6 @@ class FlashnetClientManager {
         this.poolId = null;
         this.network = null;
     }
-    /**
-     * Initialize with a SparkWallet instance.
-     * @param wallet - SparkWallet from @buildonspark/spark-sdk
-     * @param sparkNetwork - The Spark network ('mainnet' | 'regtest')
-     */
     initialize(wallet, sparkNetwork) {
         if (this.initPromise)
             return this.initPromise;
@@ -48,11 +49,12 @@ class FlashnetClientManager {
             throw new Error('Flashnet is only available when Spark is on mainnet or regtest.');
         }
         try {
-            const { FlashnetClient } = await import('@flashnet/sdk');
+            // The SDK accepts SparkWallet | IssuerSparkWallet but doesn't export a
+            // shared base — the cast keeps the call site honest while letting the
+            // rest of the file enjoy real types from the SDK.
             this.client = new FlashnetClient(wallet);
             await this.client.initialize();
             this.network = network;
-            // Auto-discover the largest BTC/USDB pool
             try {
                 const poolsResponse = await this.client.listPools({
                     assetAAddress: BTC_ASSET_PUBKEY,
@@ -61,12 +63,22 @@ class FlashnetClientManager {
                 });
                 const pools = normalizePoolsResponse(poolsResponse);
                 if (pools && pools.length > 0) {
-                    this.poolId = pools[0].lpPublicKey;
+                    // listPools returns LpPublicKey identifiers; we store the first
+                    // (highest-TVL) BTC↔USDB pool as the default for swap UX.
+                    const first = pools[0];
+                    if (first?.lpPublicKey)
+                        this.poolId = first.lpPublicKey;
                 }
             }
             catch (error) {
-                console.warn('[FlashnetClientManager] Pool discovery failed:', error);
+                log.warn('[FlashnetClientManager] Pool discovery failed:', error);
             }
+            // Backfill outgoing-swap history into the sent-token outbox so past
+            // token swaps (e.g. USDB → BTC) appear as sends in transaction history.
+            // Flashnet's AMM swap endpoint is the authoritative, retroactive source
+            // of direction — the Spark SDK exposes none for token transactions.
+            // Best-effort and async: never blocks or fails wallet init.
+            void this.backfillSwapHistory(wallet);
         }
         catch (error) {
             this.client = null;
@@ -76,12 +88,84 @@ class FlashnetClientManager {
             throw new Error(`Failed to initialize FlashnetClient: ${message}`);
         }
     }
+    /**
+     * Fetch the wallet's AMM swap history and persist the outgoing (token-in)
+     * legs to the sent-token outbox.
+     *
+     * A swap moves a token to the pool via an internal SDK transfer that the
+     * Spark token-transaction query cannot classify as a send. Flashnet's
+     * `GET /v1/swaps/user/{pubkey}` returns every past swap with explicit
+     * direction (assetIn / amountIn / inboundTransferId), so this both fixes
+     * future swaps and recovers ones made before any recording existed.
+     *
+     * Idempotent — records are keyed by transfer hash, so re-running on each
+     * connect simply refreshes them.
+     */
+    async backfillSwapHistory(wallet) {
+        const client = this.client;
+        if (!client)
+            return;
+        // `toHumanReadableTokenIdentifier` is private on FlashnetClient; the swap
+        // endpoint may return hex token ids, so normalize to the bech32 form the
+        // rest of the wallet uses when possible.
+        const toHumanReadable = (raw) => {
+            try {
+                const fn = client
+                    .toHumanReadableTokenIdentifier;
+                return fn ? fn.call(client, raw) : raw;
+            }
+            catch {
+                return raw;
+            }
+        };
+        try {
+            const senderSparkAddress = (await wallet.getSparkAddress());
+            const { swaps } = await client.getUserSwaps(undefined, {
+                sort: 'timestampDesc',
+                limit: 200,
+            });
+            let recorded = 0;
+            for (const swap of swaps ?? []) {
+                // Only the token-in leg is an outflow that needs the outbox. The
+                // token-out leg of a swap is a receive, already returned by the
+                // Spark token-transaction query.
+                const assetIn = swap?.assetInAddress;
+                const inboundTransferId = swap?.inboundTransferId;
+                if (!assetIn || assetIn === BTC_ASSET_PUBKEY || !inboundTransferId)
+                    continue;
+                const assetId = toHumanReadable(assetIn);
+                const isUsdb = isUsdbTokenAddress(assetId);
+                const parsedTs = Date.parse(swap?.timestamp ?? '');
+                await saveSentTokenRecord({
+                    hash: inboundTransferId,
+                    senderSparkAddress,
+                    amount: Number(swap?.amountIn ?? 0) || 0,
+                    assetId,
+                    ticker: isUsdb ? 'USDB' : 'TOKEN',
+                    name: isUsdb ? 'USDB' : assetId,
+                    decimals: isUsdb ? USDB_DECIMALS : 0,
+                    timestamp: Number.isFinite(parsedTs) ? parsedTs : Date.now(),
+                });
+                recorded += 1;
+            }
+            if (recorded > 0) {
+                log.info(`[FlashnetClientManager] Backfilled ${recorded} outgoing swap(s) into token history`);
+            }
+        }
+        catch (error) {
+            log.warn('[FlashnetClientManager] Swap history backfill failed:', error);
+        }
+    }
     getClient() {
         if (!this.client) {
             throw new Error('FlashnetClient not initialized. Call initialize() first.');
         }
         return this.client;
     }
+    /** Convenience pass-through so callers don't need to await client.getBalance() through a cast. */
+    async getBalance() {
+        return this.getClient().getBalance();
+    }
     getPoolId() {
         return this.poolId;
     }
@@ -103,7 +187,7 @@ class FlashnetClientManager {
                 await this.client.cleanup();
             }
             catch (error) {
-                console.warn('[FlashnetClientManager] Disconnect error:', error);
+                log.warn('[FlashnetClientManager] Disconnect error:', error);
             }
         }
         this.client = null;

package/dist/lib/flashnet-client-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"flashnet-client-manager.js","sourceRoot":"","sources":["../../src/lib/flashnet-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,2BAA2B,GAE5B,MAAM,mBAAmB,CAAA;AAE1B;;;GAGG;AACH,SAAS,sBAAsB,CAAC,QAAiB;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC5C,IACE,QAAQ;QACR,OAAO,QAAQ,KAAK,QAAQ;QAC5B,KAAK,CAAC,OAAO,CAAE,QAAkC,CAAC,KAAK,CAAC,EACxD,CAAC;QACD,OAAQ,QAAiC,CAAC,KAAc,CAAA;IAC1D,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,MAAM,qBAAqB;IAA3B;QACU,WAAM,GAAQ,IAAI,CAAA;QAClB,gBAAW,GAAyB,IAAI,CAAA;QACxC,WAAM,GAAkB,IAAI,CAAA;QAC5B,YAAO,GAA2B,IAAI,CAAA;IA6FhD,CAAC;IA3FC;;;;OAIG;IACH,UAAU,CAAC,MAAW,EAAE,YAAqB;QAC3C,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAA;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACtE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACzB,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,MAAW,EAAE,YAAqB;QAC3D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACzB,CAAC;QAED,MAAM,OAAO,GAAG,0BAA0B,CAAC,YAAY,CAAC,CAAA;QACxD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;QACpF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;YACxD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;YACxC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;YAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;YAEtB,0CAA0C;YAC1C,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;oBAChD,aAAa,EAAE,gBAAgB;oBAC/B,aAAa,EAAE,2BAA2B,CAAC,OAAO,CAAC;oBACnD,IAAI,EAAE,UAAU;iBACjB,CAAC,CAAA;gBACF,MAAM,KAAK,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAA;gBACnD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAA;gBACpC,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,gDAAgD,EAAE,KAAK,CAAC,CAAA;YACvE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;YACnB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;QAC7E,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,mBAAmB;QACjB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;QAC/E,CAAC;QACD,OAAO,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAA;YAClE,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"flashnet-client-manager.js","sourceRoot":"","sources":["../../src/lib/flashnet-client-manager.ts"],"names":[],"mappings":"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"}

package/dist/lib/orchestra-client.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Flashnet Orchestra REST API Client
+ *
+ * Cross-chain swap orchestration: stablecoins (USDC/USDT) and native assets
+ * (ETH/SOL/TRX) on EVM/Solana/Tron ↔ BTC/USDB on Spark.
+ *
+ * API docs: https://docs.flashnet.xyz/products/orchestration/overview
+ * Base URL: https://orchestration.flashnet.xyz
+ *
+ * Ported from rate-extension/src/protocols/spark/orchestra-client.ts. The API
+ * key is NOT read from a build-time env var here — the engine is platform-
+ * agnostic, so the consumer injects it once at startup via `setOrchestraApiKey()`
+ * (the extension supplies its inlined `VITE_FLASHNET_ORCHESTRA_KEY`).
+ */
+/**
+ * Register the Orchestra API key. Call once at startup. Warns if given an
+ * empty value so a misconfigured build is obvious instead of surfacing as a
+ * runtime 401 that looks like a network failure.
+ */
+export declare function setOrchestraApiKey(key: string | null | undefined): void;
+/**
+ * Stable marker embedded in the auth-error message. Only `Error.message`
+ * survives the background-SW → UI message boundary (see background-protocol.ts:
+ * `sendResponse({ error: error?.message })`), so the UI matches on this token
+ * rather than `instanceof OrchestraAuthError`.
+ */
+export declare const ORCHESTRA_AUTH_ERROR_CODE = "ORCHESTRA_AUTH_FAILED";
+/**
+ * Thrown when an authed Orchestra call fails due to a missing/invalid API key
+ * (HTTP 401/403). Callers can detect this to show a "Bridge unavailable /
+ * not configured" message instead of a generic "Quote failed".
+ */
+export declare class OrchestraAuthError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+export interface OrchestraRouteAsset {
+    chain: string;
+    asset: string;
+    contractAddress?: string;
+    decimals: number;
+    chainId?: number;
+}
+export interface OrchestraRoute {
+    sourceChain: string;
+    sourceAsset: string;
+    destinationChain: string;
+    destinationAsset: string;
+    source?: OrchestraRouteAsset;
+    destination?: OrchestraRouteAsset;
+}
+export interface OrchestraEstimate {
+    estimatedOut: string;
+    feeAmount: string;
+    feeBps: number;
+    totalFeeAmount: string;
+    feeAsset: string;
+    route: OrchestraRoute;
+}
+export interface OrchestraQuote {
+    quoteId: string;
+    depositAddress: string;
+    amountIn: string;
+    estimatedOut: string;
+    feeAmount: string;
+    feeBps: number;
+    totalFeeAmount: string;
+    feeAsset: string;
+    route: OrchestraRoute;
+    expiresAt: string;
+}
+export type OrchestraOrderStatus = 'processing' | 'confirming' | 'bridging' | 'swapping' | 'awaiting_approval' | 'refunding' | 'delivering' | 'completed' | 'failed' | 'refunded';
+export interface OrchestraOrderStage {
+    stage: string;
+    timestamp: string;
+}
+export interface OrchestraOrder {
+    id: string;
+    quoteId: string;
+    status: OrchestraOrderStatus;
+    amountIn?: string;
+    amountOut?: string;
+    depositAddress?: string;
+    recipientAddress?: string;
+    route?: OrchestraRoute;
+    stages?: OrchestraOrderStage[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface OrchestraOrderLookup {
+    quote: OrchestraQuote | null;
+    order: OrchestraOrder | null;
+    stages?: OrchestraOrderStage[];
+}
+export interface CreateQuoteParams {
+    sourceChain: string;
+    sourceAsset: string;
+    destinationChain: string;
+    destinationAsset: string;
+    amount: string;
+    recipientAddress: string;
+    slippageBps?: number;
+}
+export interface SubmitOrderParams {
+    quoteId: string;
+    txHash?: string;
+    sourceAddress?: string;
+    sparkTxHash?: string;
+    sourceSparkAddress?: string;
+    bitcoinTxid?: string;
+    bitcoinVout?: number;
+}
+export interface EstimateParams {
+    sourceChain: string;
+    sourceAsset: string;
+    destinationChain: string;
+    destinationAsset: string;
+    amount: string;
+}
+/** List all available cross-chain routes. No auth required. */
+export declare function getRoutes(): Promise<OrchestraRoute[]>;
+/** Get a lightweight price estimate. No auth required. */
+export declare function getEstimate(params: EstimateParams): Promise<OrchestraEstimate>;
+/** Create a durable quote with deposit address. Auth required. TTL ~30 min. */
+export declare function createQuote(params: CreateQuoteParams): Promise<OrchestraQuote>;
+/** Look up a quote and its associated order (if any). Auth required. */
+export declare function getOrder(quoteId: string): Promise<OrchestraOrderLookup>;
+/** Submit deposit proof to create an order from a quote. Auth required. */
+export declare function submitOrder(params: SubmitOrderParams): Promise<{
+    orderId: string;
+    status: string;
+}>;
+/**
+ * Check order status by ID, quoteId, or txHash.
+ *
+ * The Flashnet orchestration `/v1/orchestration/status` endpoint historically
+ * returned a flat `OrchestraOrder`, but the live API now wraps the response
+ * as `{ order: OrchestraOrder, stages?: OrchestraOrderStage[] }` (same shape
+ * as `/order`). Both forms have been observed in the wild — we unwrap defensively
+ * so the bridge tracking poller sees a real `status` field either way.
+ * Without this, `status` is `undefined`, the poller silently keeps showing
+ * the stale local status (e.g. "swapping") even after the order completes.
+ */
+export declare function getStatus(query: {
+    id?: string;
+    quoteId?: string;
+    txHash?: string;
+}): Promise<OrchestraOrder>;
+//# sourceMappingURL=orchestra-client.d.ts.map

package/dist/lib/orchestra-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestra-client.d.ts","sourceRoot":"","sources":["../../src/lib/orchestra-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/orchestra-client.js

@@ -0,0 +1,178 @@
+/**
+ * Flashnet Orchestra REST API Client
+ *
+ * Cross-chain swap orchestration: stablecoins (USDC/USDT) and native assets
+ * (ETH/SOL/TRX) on EVM/Solana/Tron ↔ BTC/USDB on Spark.
+ *
+ * API docs: https://docs.flashnet.xyz/products/orchestration/overview
+ * Base URL: https://orchestration.flashnet.xyz
+ *
+ * Ported from rate-extension/src/protocols/spark/orchestra-client.ts. The API
+ * key is NOT read from a build-time env var here — the engine is platform-
+ * agnostic, so the consumer injects it once at startup via `setOrchestraApiKey()`
+ * (the extension supplies its inlined `VITE_FLASHNET_ORCHESTRA_KEY`).
+ */
+import { log } from './log.js';
+const BASE_URL = 'https://orchestration.flashnet.xyz';
+/**
+ * Orchestra API key, injected by the consumer. PUBLIC-by-design in the
+ * extension (shipped in the bundle) — the seam simply keeps the build-time
+ * env-var read out of the engine. Empty until `setOrchestraApiKey()` runs;
+ * every authed endpoint (createQuote/getOrder/submitOrder/getStatus) 401s
+ * without it.
+ */
+let apiKey = '';
+/**
+ * Register the Orchestra API key. Call once at startup. Warns if given an
+ * empty value so a misconfigured build is obvious instead of surfacing as a
+ * runtime 401 that looks like a network failure.
+ */
+export function setOrchestraApiKey(key) {
+    apiKey = key ?? '';
+    if (!apiKey) {
+        log.warn('[Orchestra] API key is empty — Bridge quote/submit calls will fail with HTTP 401. ' +
+            'Pass a key to setOrchestraApiKey() at startup.');
+    }
+}
+/**
+ * Stable marker embedded in the auth-error message. Only `Error.message`
+ * survives the background-SW → UI message boundary (see background-protocol.ts:
+ * `sendResponse({ error: error?.message })`), so the UI matches on this token
+ * rather than `instanceof OrchestraAuthError`.
+ */
+export const ORCHESTRA_AUTH_ERROR_CODE = 'ORCHESTRA_AUTH_FAILED';
+/**
+ * Thrown when an authed Orchestra call fails due to a missing/invalid API key
+ * (HTTP 401/403). Callers can detect this to show a "Bridge unavailable /
+ * not configured" message instead of a generic "Quote failed".
+ */
+export class OrchestraAuthError extends Error {
+    constructor(status) {
+        super(`${ORCHESTRA_AUTH_ERROR_CODE}: Bridge is not configured or unavailable. ` +
+            'The cross-chain service rejected the request (authentication failed).');
+        this.name = 'OrchestraAuthError';
+        this.status = status;
+    }
+}
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+function authHeaders() {
+    if (!apiKey)
+        return {};
+    return { Authorization: `Bearer ${apiKey}` };
+}
+function idempotencyHeader(prefix) {
+    return { 'X-Idempotency-Key': `${prefix}:${crypto.randomUUID()}` };
+}
+async function request(method, path, opts) {
+    const url = new URL(path, BASE_URL);
+    if (opts?.params) {
+        for (const [k, v] of Object.entries(opts.params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, v);
+        }
+    }
+    const headers = { 'Content-Type': 'application/json' };
+    if (opts?.auth)
+        Object.assign(headers, authHeaders());
+    if (opts?.idempotency)
+        Object.assign(headers, idempotencyHeader(opts.idempotency));
+    const res = await fetch(url.toString(), {
+        method,
+        headers,
+        body: opts?.body ? JSON.stringify(opts.body) : undefined,
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        // An auth failure on an authed call almost always means the API key was
+        // not injected (or is invalid). Throw a specific error so the UI can
+        // distinguish "Bridge not configured" from a transient quote error.
+        if (opts?.auth && (res.status === 401 || res.status === 403)) {
+            throw new OrchestraAuthError(res.status);
+        }
+        throw new Error(`Orchestra API ${method} ${path} failed (${res.status}): ${text}`);
+    }
+    return res.json();
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** List all available cross-chain routes. No auth required. */
+export async function getRoutes() {
+    const res = await request('GET', '/v1/orchestration/routes');
+    // API wraps in { routes: [...] }
+    return Array.isArray(res) ? res : res.routes;
+}
+/** Get a lightweight price estimate. No auth required. */
+export async function getEstimate(params) {
+    return request('GET', '/v1/orchestration/estimate', {
+        params: {
+            sourceChain: params.sourceChain,
+            sourceAsset: params.sourceAsset,
+            destinationChain: params.destinationChain,
+            destinationAsset: params.destinationAsset,
+            amount: params.amount,
+        },
+    });
+}
+/** Create a durable quote with deposit address. Auth required. TTL ~30 min. */
+export async function createQuote(params) {
+    return request('POST', '/v1/orchestration/quote', {
+        body: {
+            sourceChain: params.sourceChain,
+            sourceAsset: params.sourceAsset,
+            destinationChain: params.destinationChain,
+            destinationAsset: params.destinationAsset,
+            amount: params.amount,
+            recipientAddress: params.recipientAddress,
+            slippageBps: params.slippageBps ?? 100,
+        },
+        auth: true,
+        idempotency: 'quote:create',
+    });
+}
+/** Look up a quote and its associated order (if any). Auth required. */
+export async function getOrder(quoteId) {
+    return request('GET', '/v1/orchestration/order', {
+        params: { quoteId },
+        auth: true,
+    });
+}
+/** Submit deposit proof to create an order from a quote. Auth required. */
+export async function submitOrder(params) {
+    return request('POST', '/v1/orchestration/submit', {
+        body: params,
+        auth: true,
+        idempotency: 'submit',
+    });
+}
+/**
+ * Check order status by ID, quoteId, or txHash.
+ *
+ * The Flashnet orchestration `/v1/orchestration/status` endpoint historically
+ * returned a flat `OrchestraOrder`, but the live API now wraps the response
+ * as `{ order: OrchestraOrder, stages?: OrchestraOrderStage[] }` (same shape
+ * as `/order`). Both forms have been observed in the wild — we unwrap defensively
+ * so the bridge tracking poller sees a real `status` field either way.
+ * Without this, `status` is `undefined`, the poller silently keeps showing
+ * the stale local status (e.g. "swapping") even after the order completes.
+ */
+export async function getStatus(query) {
+    const params = {};
+    if (query.id)
+        params.id = query.id;
+    else if (query.quoteId)
+        params.quoteId = query.quoteId;
+    else if (query.txHash)
+        params.txHash = query.txHash;
+    const raw = await request('GET', '/v1/orchestration/status', { params, auth: true });
+    // Wrapped shape: pull the order, attach stages so callers can use them
+    // for finer-grained progress UI without a second request.
+    if (raw && typeof raw === 'object' && 'order' in raw && raw.order) {
+        const wrapped = raw;
+        return wrapped.stages ? { ...wrapped.order, stages: wrapped.stages } : wrapped.order;
+    }
+    return raw;
+}
+//# sourceMappingURL=orchestra-client.js.map

package/dist/lib/orchestra-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestra-client.js","sourceRoot":"","sources":["../../src/lib/orchestra-client.ts"],"names":[],"mappings":"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"}

package/dist/types/flashnet.d.ts

@@ -1,15 +1,35 @@
 /**
  * Flashnet Protocol Types
  * Ported from rate-extension/src/protocols/types/flashnet.ts
+ *
+ * Re-exports the @flashnet/sdk types we lean on so call sites have a single
+ * import surface. These are type-only re-exports — erased at compile time — so
+ * the SDK-free root barrel stays runtime-clean even though it does
+ * `export * from './types/flashnet'`.
  */
+export type { FlashnetClient, WalletBalance, TokenBalance } from '@flashnet/sdk';
+export type { SimulateSwapRequest, SimulateSwapResponse, SwapResponse, SimulateRouteSwapRequest, SimulateRouteSwapResponse, ExecuteRouteSwapResponse, ListPoolsQuery, ListPoolsResponse, PoolDetailsResponse, PoolLiquidityResponse, ListPoolSwapsQuery, ListPoolSwapsResponse, ListUserSwapsQuery, ListUserSwapsResponse, FlashnetErrorCode, FlashnetErrorResponseBody, } from '@flashnet/sdk';
 export type FlashnetNetwork = 'mainnet' | 'regtest';
 export declare const USDB_TOKEN_ADDRESS: Record<'mainnet' | 'regtest', string>;
+export declare const USDB_TOKEN_ADDRESS_ALIASES: string[];
 export declare const BTC_ASSET_PUBKEY = "020202020202020202020202020202020202020202020202020202020202020202";
 export declare const USDB_DECIMALS = 6;
 export declare const BTC_DECIMALS = 8;
+export declare const FLASHNET_API_URL: Record<'mainnet' | 'regtest', string>;
+export declare const FLASHNET_REWARDS_API_URL = "https://rewards.flashnet.xyz";
+export declare const FLASHNET_USDB_REWARDS_DOC_URL = "https://docs.flashnet.xyz/usdb/rewards";
+export declare const SPARK_BALANCES_DOC_URL = "https://docs.spark.money/wallets/balances";
 export declare const DEFAULT_SLIPPAGE_BPS = 500;
+export interface UsdbRewardTier {
+    minBalance: number;
+    rate: number;
+    label: string;
+}
+export declare const USDB_REWARD_TIERS: UsdbRewardTier[];
 export declare function getFlashnetNetworkForSpark(sparkNetwork: string | null | undefined): FlashnetNetwork | null;
 export declare function getFlashnetUsdbTokenAddress(network: FlashnetNetwork): string;
+export declare function isUsdbTokenAddress(value: string | null | undefined): boolean;
+export declare function getUsdbRewardRate(usdbBalance: number): number;
 export interface FlashnetSwapSimulation {
     amountOut: bigint;
     executionPrice: number;

package/dist/types/flashnet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flashnet.d.ts","sourceRoot":"","sources":["../../src/types/flashnet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAA;AAEnD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,EAAE,MAAM,CAGpE,CAAA;AAED,eAAO,MAAM,gBAAgB,uEAAuE,CAAA;AAEpG,eAAO,MAAM,aAAa,IAAI,CAAA;AAC9B,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,eAAe,GAAG,IAAI,CAIxB;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE5E;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb"}
+{"version":3,"file":"flashnet.d.ts","sourceRoot":"","sources":["../../src/types/flashnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAChF,YAAY,EAEV,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EAEZ,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EAExB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EAErB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EAErB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,eAAe,CAAA;AAEtB,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAA;AAGnD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,EAAE,MAAM,CAGpE,CAAA;AAED,eAAO,MAAM,0BAA0B,UAGtC,CAAA;AAED,eAAO,MAAM,gBAAgB,uEACyC,CAAA;AAEtE,eAAO,MAAM,aAAa,IAAI,CAAA;AAC9B,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,EAAE,MAAM,CAGlE,CAAA;AAED,eAAO,MAAM,wBAAwB,iCAAiC,CAAA;AACtE,eAAO,MAAM,6BAA6B,2CAA2C,CAAA;AACrF,eAAO,MAAM,sBAAsB,8CAA8C,CAAA;AAEjF,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAI7C,CAAA;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,eAAe,GAAG,IAAI,CAKxB;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE5E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAI5E;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb"}

package/dist/types/flashnet.js

@@ -1,23 +1,51 @@
-/**
- * Flashnet Protocol Types
- * Ported from rate-extension/src/protocols/types/flashnet.ts
- */
+// Mainnet and regtest share one canonical USDB token address.
 export const USDB_TOKEN_ADDRESS = {
     mainnet: 'btkn1xgrvjwey5ngcagvap2dzzvsy4uk8ua9x69k82dwvt5e7ef9drm9qztux87',
     regtest: 'btkn1xgrvjwey5ngcagvap2dzzvsy4uk8ua9x69k82dwvt5e7ef9drm9qztux87',
 };
+export const USDB_TOKEN_ADDRESS_ALIASES = [
+    USDB_TOKEN_ADDRESS.mainnet,
+    'btknrt1xgrvjwey5ngcagvap2dzzvsy4uk8ua9x69k82dwvt5e7ef9drm9qp48s74',
+];
 export const BTC_ASSET_PUBKEY = '020202020202020202020202020202020202020202020202020202020202020202';
 export const USDB_DECIMALS = 6;
 export const BTC_DECIMALS = 8;
+export const FLASHNET_API_URL = {
+    mainnet: 'https://api.flashnet.xyz',
+    regtest: 'https://api.amm.makebitcoingreatagain.dev',
+};
+export const FLASHNET_REWARDS_API_URL = 'https://rewards.flashnet.xyz';
+export const FLASHNET_USDB_REWARDS_DOC_URL = 'https://docs.flashnet.xyz/usdb/rewards';
+export const SPARK_BALANCES_DOC_URL = 'https://docs.spark.money/wallets/balances';
 export const DEFAULT_SLIPPAGE_BPS = 500;
+export const USDB_REWARD_TIERS = [
+    { minBalance: 10, rate: 0.035, label: '3.5%' },
+    { minBalance: 1000, rate: 0.045, label: '4.5%' },
+    { minBalance: 10000, rate: 0.06, label: '6%' },
+];
 export function getFlashnetNetworkForSpark(sparkNetwork) {
-    if (sparkNetwork === 'mainnet')
+    const normalized = sparkNetwork?.trim().toLowerCase();
+    if (normalized === 'mainnet')
         return 'mainnet';
-    if (sparkNetwork === 'regtest')
+    if (normalized === 'regtest')
         return 'regtest';
     return null;
 }
 export function getFlashnetUsdbTokenAddress(network) {
     return USDB_TOKEN_ADDRESS[network];
 }
+export function isUsdbTokenAddress(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return USDB_TOKEN_ADDRESS_ALIASES.some((alias) => alias.toLowerCase() === normalized);
+}
+export function getUsdbRewardRate(usdbBalance) {
+    let rate = 0;
+    for (const tier of USDB_REWARD_TIERS) {
+        if (usdbBalance >= tier.minBalance)
+            rate = tier.rate;
+    }
+    return rate;
+}
 //# sourceMappingURL=flashnet.js.map

package/dist/types/flashnet.js.map

@@ -1 +1 @@
-{"version":3,"file":"flashnet.js","sourceRoot":"","sources":["../../src/types/flashnet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAA0C;IACvE,OAAO,EAAE,iEAAiE;IAC1E,OAAO,EAAE,iEAAiE;CAC3E,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,oEAAoE,CAAA;AAEpG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAA;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAA;AAE7B,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAA;AAEvC,MAAM,UAAU,0BAA0B,CACxC,YAAuC;IAEvC,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAChD,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAChD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAwB;IAClE,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC"}
+{"version":3,"file":"flashnet.js","sourceRoot":"","sources":["../../src/types/flashnet.ts"],"names":[],"mappings":"AAoCA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAA0C;IACvE,OAAO,EAAE,iEAAiE;IAC1E,OAAO,EAAE,iEAAiE;CAC3E,CAAA;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,kBAAkB,CAAC,OAAO;IAC1B,mEAAmE;CACpE,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAC3B,oEAAoE,CAAA;AAEtE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAA;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAA;AAE7B,MAAM,CAAC,MAAM,gBAAgB,GAA0C;IACrE,OAAO,EAAE,0BAA0B;IACnC,OAAO,EAAE,2CAA2C;CACrD,CAAA;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CAAA;AACtE,MAAM,CAAC,MAAM,6BAA6B,GAAG,wCAAwC,CAAA;AACrF,MAAM,CAAC,MAAM,sBAAsB,GAAG,2CAA2C,CAAA;AAEjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAA;AAQvC,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;IAC9C,EAAE,UAAU,EAAE,IAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;IACjD,EAAE,UAAU,EAAE,KAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;CAChD,CAAA;AAED,MAAM,UAAU,0BAA0B,CACxC,YAAuC;IAEvC,MAAM,UAAU,GAAG,YAAY,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACrD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC9C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC9C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAwB;IAClE,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAgC;IACjE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC7C,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAA;AACvF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,IAAI,WAAW,IAAI,IAAI,CAAC,UAAU;YAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACtD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaleidorg/wallet-engine",
-  "version": "1.0.0-beta.37",
+  "version": "1.0.0-beta.38",
   "description": "WDK-based multi-protocol wallet engine (Spark, RGB/RLN, Liquid, Arkade): IProtocolAdapter contract + WDK adapters, cross-protocol router, BIP321 unified receive, and lite/advanced disclosure.",
   "type": "module",
   "main": "dist/index.js",
@@ -26,6 +26,10 @@
       "types": "./dist/adapters/rgb.d.ts",
       "default": "./dist/adapters/rgb.js"
     },
+    "./adapters/flashnet": {
+      "types": "./dist/adapters/flashnet.d.ts",
+      "default": "./dist/adapters/flashnet.js"
+    },
     "./adapters/wdk": {
       "types": "./dist/adapters/wdk/index.d.ts",
       "default": "./dist/adapters/wdk/index.js"