madeonsol-x402 3.2.1 → 4.1.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 MadeOnSol
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 MadeOnSol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,8 @@
 # madeonsol-x402
 
+> **New in 4.1.0: managed ShredPrism early-stream client (additive).** `MadeOnSolREST.earlyStream()` plus the `walletTrades()` / `followTokens()` subscription helpers connect to the separate ULTRA/BUSINESS/ENTERPRISE early gateway with the same stream token: reconnect with backoff, separate safe checkpoints per subscription, bounded process-local replay with deduplication, explicit gaps, optional `compact-v1` frames (expanded before your callback) and private saved wallet list controls (`manageWalletList()`). It only connects when `getStreamToken()` advertises `early_ws_url`, and only the channels listed in `early_stream.channels` are served; otherwise it stops with `early_stream_unavailable` or a server rejection. New types: `EarlyChannel`, `EarlyStreamFilters`, `EarlyAmountFilter`, `EarlySubscribeControl`, `EarlyUpdateControl`, `EarlyWalletList*`; `StreamToken.early_stream` gains the six channel names and `coverage`. Observations are provisional instruction intent, not executed fills; coverage is partial and replay is never durable history. Existing methods are unchanged.
+
+
 [![npm version](https://img.shields.io/npm/v/madeonsol-x402?style=flat-square)](https://www.npmjs.com/package/madeonsol-x402)
 [![npm downloads](https://img.shields.io/npm/dm/madeonsol-x402?style=flat-square)](https://www.npmjs.com/package/madeonsol-x402)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.4+-blue?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
@@ -17,6 +20,8 @@ TypeScript SDK for the [MadeOnSol](https://madeonsol.com) Solana KOL intelligenc
 
 > **Server update 2026-10-04 (no package change needed): copy-trade rules follow any valid source wallet.** `source_wallets` no longer have to be tracked KOL wallets: any valid Solana wallet fires, KOL membership is optional enrichment, and copy-trade sources do not use Wallet Tracker quota. Each rule reports `source_admission` (`any_wallet`) and `operational_state` (`eligible`, or an infrastructure state `monitoring_pending` / `monitoring_unavailable` / `source_capacity_unavailable`). `source_wallets_tracked` / `source_wallets_untracked` and the `untracked_source_wallets` warning are legacy fields, still filled. This supersedes the "signals fire only for tracked KOL wallets" wording in older notes below. Limits are unchanged: PRO 3 rules × 5 wallets, ULTRA 20 × 50, BUSINESS 100 × 250.
 
+> **New in 4.0.0: sniper is ULTRA+ only and no longer keyless (breaking).** `sniperRecent()` in keyless (x402) mode now throws `KeylessNotAvailableError` before any request or payment: the server retired `/api/x402/sniper/recent` on 2026-10-06 (HTTP 410 `x402_endpoint_retired`, nothing charged). With an ULTRA, BUSINESS or ENTERPRISE API key `sniperRecent()` / `sniperByDeployer()` work as before (PRO keys now get 403 `tier_required`). Types: `SniperDeploy` gains the early-observation fields (`event_id`, `source` shredprism | deshred, `outer_instruction_index`, `observation_stage`, `execution_status`, `transaction_version`, `transaction_config`, `fee_payer`), `sniperByDeployer()` returns the typed `SniperByDeployerResponse`, `attribution_status` is the closed set unverified | confirmed | corrected, and `StreamToken` gains `early_ws_url` / `early_stream` (ULTRA+ only, present while the early stream is active). Observations are intent, not execution proof.
+
 > **New in 2.9.0: token lock provenance.** Typed: Token lock rows carry `provider` (`identity` verified | compatible | unverified; `lock_url` always null on Solana, never constructed), `explorer` (Solana Explorer links), `price_usd`, `seconds_until_end`, `seconds_until_next_unlock` and, for Bonfida, the tranche `schedule` (server 2026-10-02). Additive only.
 
 > **New in 3.2.0: deployer activity timeline.** `client.deployerActivity(wallet, { limit?, cursor?, since?, types? })` (typed `DeployerActivityResponse`) binds `GET /deployer-hunter/{wallet}/activity`: one newest-first timeline of launches, the deployer's own dev buys/sells, creator transfers, fee claims, funding in and capital out, windowed on each event's own time (PRO 30 d, ULTRA 365 d, BUSINESS unbounded; page clamped to 100 / 100 / 500). History is online-only for now: read `coverage.families.<family>.complete`, `archive_required_before` and `plan.history.archive_only` before treating an empty range as "nothing happened"; `skipped_reason: "no_attributed_launch"` marks a wallet with no attributed launch. PRO+, keyed (v1) only.
@@ -199,9 +204,9 @@ A new client or process starts a new allowance. These limits are not a durable,
 | `almostBonded(params?)` | **New 1.21** · Launchpad tokens approaching graduation (pump.fun + LetsBonk LaunchLab) — bonding progress, velocity (Δprogress/min), ETA, deployer tier. **$0.01** |
 | `tokenTopTraders(mint, params?)` | **New 1.21** · Wallets ranked by realized PnL (or ROI) on a token, enriched with KOL identity + alpha reputation. **$0.02** |
 | `tokenCapTable(mint)` | **New 1.21** · Early-buyer cap table — first 10 non-deployer buyers with PnL, exit status, bundle/KOL/alpha flags + buyer-quality score. **$0.02** |
-| `sniperRecent(params?)` | **New 1.21** · Deshred sniper deploy feed (elite/good deployers) with per-deploy snipe `footprint`. **$0.01** |
+| `sniperRecent(params?)` | Retired in keyless mode; raises `KeylessNotAvailableError` before the request. Use an ULTRA/BUSINESS/ENTERPRISE API key. |
 | `deployerTrajectory(wallet, params?)` | **New 1.21** · Deployer bond-rate trajectory — streaks, rolling bond rates, trend, cadence. `include: "daily_snapshots"` adds 90 days. **$0.01** |
-| `discovery()` | Lists all 25 endpoints, prices, and parameter docs (free) |
+| `discovery()` | Lists the current keyless endpoints, prices, and parameter docs (free) |
 
 **API key only (not on the x402 rail):** `scoutLeaderboard()`, `coordinationHistory()`, `kolConsensus()`, `peakHistory()` and `tokenBundle()` have no keyless x402 route (the server answers 404). With an API key they call `/api/v1/` as before; in private-key (x402) mode they throw `KeylessNotAvailableError` before any request or payment. The list is exported as `X402_UNAVAILABLE_PATHS`. `discovery()` returns the live x402 catalog.
 
@@ -253,7 +258,7 @@ Scored from 1.5M+ early-buyer records (wallets seen in the first 20 buyers of Pu
 | `rest.tokenCandles(mint, params?)` | PRO+ | OHLC candles. PRO = OHLCV, last 30 days; ULTRA = + net flow (buy/sell volume, `net_volume_usd`, counts, MEV vol), liquidity delta, full history |
 | `rest.tokenTrades(mint, params?)` | PRO+ | **New 1.21** · Mint-scoped trade tape — cursor-paginated raw trades (`price_sol`/`price_usd`, `early_buyer_rank`, `slot`), filter by `action`/`wallet`/`since`/`until`. Default window = **full history**; `coverage` block carries `history_start` (2026-04-12) + `scope` (pump.fun pipeline) |
 | `rest.tokenTopTraders(mint, params?)` | PRO+ | **New 1.21** · Wallets ranked by realized PnL (or ROI) on a token — `sort` ("pnl" \| "roi"), `window_days` (1–180), `min_bought_sol`; enriched with KOL identity + alpha reputation (`bot_confidence`, historical win rate/PnL) |
-| `rest.sniperRecent(params?)` | PRO+ | **New 1.21** · Deshred sniper deploy feed — PRO sees elite/good deployers, ULTRA all tiers. Each deploy carries a slot-window snipe `footprint` (`buys`/`buyers`/`sol`/`supply_pct`/`sniper_wallet_buys`; null until the ~10-min settle window) |
+| `rest.sniperRecent(params?)` | ULTRA/BUSINESS/ENTERPRISE | Early deploy observations with action identity and separate execution status; unknown enrichment stays null. |
 
 **tokenCandles params** — `tf` ("1m" \| "5m" \| "15m" \| "1h" \| "4h" \| "1d", default "1h"), `limit` (1–1000, default 200), `from` (ISO 8601), `to` (ISO 8601)
 
@@ -637,3 +642,164 @@ Docs: [madeonsol.com/solana-api](https://madeonsol.com/solana-api)
 | MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) · [Smithery](https://smithery.ai/servers/madeonsol/solana-kol-intelligence) · [Glama](https://glama.ai/mcp/servers/madeonsol/mcp-server-madeonsol) |
 | ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
 | Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |
+
+## Managed ShredPrism early-stream client (4.1.0+)
+
+`MadeOnSolREST.earlyStream()` extends this SDK with the separate early protocol.
+It requires ULTRA, BUSINESS or ENTERPRISE and an `early_ws_url` in `getStreamToken()`
+discovery; subscribe only to channels listed in `early_stream.channels`.
+The existing confirmed-stream `stream()` contract is unchanged.
+
+```js
+import { MadeOnSolREST, walletTrades, followTokens } from 'madeonsol-x402';
+const api = new MadeOnSolREST({ apiKey: process.env.MADEONSOL_API_KEY });
+const stream = api.earlyStream({
+  subscriptions: [
+    walletTrades(['YOUR_WALLET'], { sub_id: 'wallets', directions: ['buy'] }),
+    followTokens(['YOUR_MINT'], { sub_id: 'token' }),
+  ],
+  onFrame(frame) {
+    // early:observed is provisional instruction intent; early:outcome reports status.
+    // Correlate outcomes through frame.data.observed_event_id.
+    console.log(frame);
+  },
+  onStatus(status) {
+    if (['gap', 'fatal', 'reconnect'].includes(status.type)) console.error(status);
+  },
+});
+stream.connect();
+// Once subscriptions are ready (and any replay has completed), await each control:
+// await stream.updateSubscription('wallets', { filters: { wallets: ['NEW_WALLET'] } });
+// await stream.updateSubscription('wallets', { format: 'compact-v1' });
+// await stream.unsubscribe('token');
+// stream.close();
+```
+
+Replace placeholder addresses before running. The repository example is
+`packages/madeonsol-x402/examples/early-stream.mjs`: build the SDK, set
+`MADEONSOL_API_KEY` plus exactly one of `EARLY_WALLETS` or `EARLY_MINTS`, and run
+that file with Node 22+. It uses the platform WebSocket; `WebSocketImpl` can inject
+`ws`.
+
+- Token acquisition uses the existing REST client on every connection. Tokens
+  do not expire automatically; the SDK never schedules rotation. Browser-compatible
+  handshake authentication uses `?token=`, which must remain redacted in proxy logs.
+  Credentials and raw REST/transport errors are excluded from SDK diagnostics.
+- Transient disconnects retry with jittered exponential backoff (500 ms to 30 s;
+  10 consecutive reconnect attempts by default). Authorization closes have a
+  three-rejection budget. A connection-limit close waits at least 60 s. Policy
+  rejection stops. Token acquisition, handshake, controls and replay have 15 s
+  deadlines. There is no additional application heartbeat; the gateway's WS
+  ping/pong remains responsible for detecting an idle broken connection.
+- Up to 10 configured subscriptions share one connection; server tier/connection
+  caps still apply. Updates and unsubscribe require a connected client and one
+  control at a time. Await each call. The SDK replaces local settings only after
+  server acknowledgement. Omitted filters remain; `{}` clears them. Use `subscribe(control)` to add a new subscription after connecting. An empty
+  initial array is supported for list-management-only sessions.
+- Frames are handled in arrival order. Async `onFrame` handlers are awaited, and
+  an exception/rejection stops the client without advancing past that event.
+  The pending queue is bounded to 2,048 frames / 8 MiB, measured in UTF-8, by default.
+  Overflow stops with `client_queue_limit`; expensive work should leave the handler.
+  Closing invalidates pending work and cancels retry/replay/control timers.
+- `getCursors()` returns separate safe checkpoints per subscription. During replay,
+  new live traffic is delivered but cannot advance the checkpoint until a complete
+  replay finishes. A disconnect mid-replay resumes from the prior safe point.
+  Incomplete replay or a reported gap freezes the checkpoint. A later complete
+  recovery can resolve it; `acceptGap(subId)` explicitly skips to received progress
+  once replay ends if the caller accepts the missing range. No gap is silently
+  accepted. Process-local replay is bounded and is never durable history.
+- Persist cursors with their matching subscription settings outside the handler,
+  after processing has completed. To restart, put each saved cursor in that
+  subscription's `resume`. Recent IDs are deduplicated per subscription and event
+  type (10,000 IDs per subscription). Deduplication is bounded and in-memory:
+  downstream processing must tolerate duplicates after eviction/restart.
+- `full` remains the default. `compact-v1` is expanded before the application
+  callback. The local managed client costs more CPU than a minimal reader; no
+  zero-overhead or customer lead-time claim is made. Keep handlers short. Current
+  protocol coverage is partial and all observations remain provisional.
+
+Full wire contract: https://madeonsol.com/docs/shredprism-stream.md.
+
+
+## Private saved wallet lists
+
+The early gateway stores named lists separately from the confirmed wallet-tracker
+watchlist. Its authenticated stream-token owner is authoritative; a request cannot
+supply another user ID. These lists are never added to public KOL/alpha rosters and
+do not change upstream wallet-tracker subscriptions.
+
+On a connected SDK client (it may start with `subscriptions: []`):
+
+```js
+const created = await stream.manageWalletList({
+  op: 'create', name: 'My wallets', wallets: ['YOUR_WALLET'],
+});
+await stream.subscribe({
+  type: 'subscribe', sub_id: 'private-trades', channels: ['early:trades'],
+  wallet_list: created.list.id,
+});
+const changed = await stream.manageWalletList({
+  op: 'replace', id: created.list.id, revision: created.list.revision,
+  name: 'My wallets', wallets: ['ANOTHER_WALLET'],
+});
+// list returns metadata + wallet_count; get returns the actual wallet array.
+await stream.manageWalletList({ op: 'list' });
+await stream.manageWalletList({ op: 'get', id: created.list.id });
+// Explicitly delete with the current revision when no longer needed:
+// await stream.manageWalletList({ op: 'delete', id: created.list.id, revision: changed.list.revision });
+```
+
+Replace the placeholder addresses, wait for the SDK `ready` status, and await each
+control. Raw WS uses `{type:"wallet_list", ...control}` and receives
+`{type:"wallet_list_result", op, list?, lists?, limits}`. Revisions are decimal
+strings. `replace` supplies the whole name/address snapshot; `replace` and `delete`
+require the current revision. A conflict leaves the existing stored row intact.
+`list` is summary-only so a full BUSINESS account cannot exceed the control-frame
+byte budget; use `get` for one list's addresses. There is no new REST endpoint.
+
+Limits reuse existing tier budgets: ULTRA 10 lists / 100 wallets per list;
+BUSINESS and ENTERPRISE 20 / 500. Lists contain 1..limit unique Solana addresses,
+with a unique owner-scoped name of 1..64 characters. Delete an empty group instead
+of subscribing with an empty wallet filter. The SDK supports 10 simultaneous
+subscriptions; server subscription and connection caps remain authoritative.
+
+A subscription's top-level `wallet_list` is an ID, valid only for `early:trades`.
+Do not combine it with `filters.wallets` or `filters.actors`; direction, amount,
+protocol and other compatible filters still intersect. Omitting it on update
+keeps the reference; explicit `wallet_list: null` detaches it, so supply replacement
+filters if the subscription should remain wallet-scoped.
+
+Subscribe/update acknowledgements and `list` controls report
+`wallet_list: {id, revision}`. A successful edit atomically replaces each active
+subscription's in-memory index, then emits `wallet_list_updated` with the active
+revision. An update arriving during replay ends the old replay as incomplete;
+clients retain the prior safe cursor. Reconnect reloads the current saved revision,
+and replay uses that current list, not historical list membership.
+
+Local successful writes are applied to current owner subscriptions immediately.
+Edits from another process are discovered by a 5-second refresh. Unchanged rows
+return their revision without resending wallet arrays. A previous snapshot is valid
+for at most 15 seconds after a successful read. On deletion, missing access, failed
+application, excess wallets after tier downgrade, or expiry, the affected binding
+is removed and `wallet_list_unavailable` is sent. The SDK surfaces it as a `gap`;
+resubscribe after correcting the cause. A transient failed read does not extend TTL.
+Normal auth expiry/downgrade enforcement still applies.
+
+A dedicated one-connection database pool handles controls/refresh, with 2-second
+query deadlines and at most 8 admitted list queries. At most 256 distinct active
+owner/list references are materialized per gateway, within the existing 100,000
+binding budget. Overload fails explicitly. Decode, matching, live publication and
+replay never query the database; delivery checks the local snapshot expiry and tier
+limit. Do not describe this bounded local implementation as zero-overhead or as
+complete wallet transaction coverage.
+
+## Client scope
+
+The managed early client ships in this TypeScript package only. The Python package,
+MCP server, ElizaOS plugin and Solana Agent Kit plugin do not include it; use the raw
+WebSocket contract there. The existing `sniperRecent()` / `sniperByDeployer()` helpers
+are separate from direct six-family subscriptions and private-list WS controls.
+
+Coverage and dated local benchmarks (with raw downloads and methodology):
+https://madeonsol.com/solutions/shredprism-stream. Those development measurements do
+not establish a fixed customer head start.

package/dist/early-codec.d.ts

@@ -0,0 +1,4 @@
+import type { EarlyFrame } from './early-stream.js';
+export declare const COMPACT_FIELDS: readonly string[];
+export declare function expandEarlyFrame(value: unknown): EarlyFrame;
+//# sourceMappingURL=early-codec.d.ts.map

package/dist/early-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"early-codec.d.ts","sourceRoot":"","sources":["../src/early-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,eAAO,MAAM,cAAc,mBAgBzB,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAc3D"}

package/dist/early-codec.js

@@ -0,0 +1,43 @@
+export const COMPACT_FIELDS = Object.freeze([
+    'schema_version', 'chain', 'channel', 'event_id', 'signature', 'observed_slot',
+    'first_observed_at', 'source', 'source_region', 'observation_stage', 'execution_status',
+    'decoding_basis', 'decoder_version', 'transaction_version', 'transaction_config',
+    'lifetime_token', 'protocol', 'instruction', 'outer_instruction_index', 'program_id',
+    'fee_payer', 'action', 'actor', 'attribution_basis', 'mint', 'quote_mint', 'pool',
+    'direction', 'swap_mode', 'input_mint', 'output_mint', 'requested_input_raw',
+    'max_input_raw', 'min_output_raw', 'target_output_raw', 'wallet_label',
+    'observed_event_id', 'outcome_source', 'commitment', 'landed_slot',
+    'execution_error', 'outcome_at', 'missing_fields', 'launchpad',
+    'requested_amount_raw', 'lp_mint', 'target_lp_output_raw', 'requested_lp_input_raw',
+    'max_base_input_raw', 'max_quote_input_raw', 'min_base_output_raw', 'min_quote_output_raw',
+    'requested_base_input_raw', 'requested_quote_input_raw', 'authority', 'authority_type',
+    'new_authority', 'authority_revocation_requested', 'target_scope', 'target_account',
+    'token_account', 'decimals', 'authority_is_signer', 'lock_account', 'lock_kind',
+    'sender', 'recipient', 'sender_token_account', 'destination_token_account', 'schedule',
+]);
+const names = new Map(COMPACT_FIELDS.map((name, i) => [i.toString(36), name]));
+export function expandEarlyFrame(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('invalid_frame');
+    const frame = value;
+    if (!['early:observed', 'early:outcome'].includes(frame.event ?? ''))
+        return frame;
+    if (frame.format === undefined || frame.format === 'full')
+        return frame;
+    if (frame.format !== 'compact-v1' || !frame.data || typeof frame.data !== 'object' || Array.isArray(frame.data))
+        throw new Error('invalid_compact_frame');
+    const data = {};
+    for (const k of Object.keys(frame.data)) {
+        const key = k.startsWith('~') ? k.slice(1) : names.get(k);
+        if (key === undefined || Object.hasOwn(data, key))
+            throw new Error('invalid_compact_frame');
+        if (key === '__proto__')
+            Object.defineProperty(data, key, { value: frame.data[k], enumerable: true, writable: true, configurable: true });
+        else
+            data[key] = frame.data[k];
+    }
+    const result = { ...frame, data };
+    delete result.format;
+    return result;
+}
+//# sourceMappingURL=early-codec.js.map

package/dist/early-codec.js.map

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

package/dist/early-stream.d.ts

@@ -0,0 +1,85 @@
+import type { EarlySubscribeControl, EarlyStreamFilters, EarlyEventFormat, EarlyWalletListControl, EarlyWalletListResult, StreamToken } from './types.js';
+export { expandEarlyFrame } from './early-codec.js';
+export type { EarlyChannel, EarlyAmountField, EarlyAmountFilter, EarlyStreamFilters, EarlyEventFormat, EarlySubscribeControl, EarlyUpdateControl } from './types.js';
+export interface EarlyCursor {
+    instance: string;
+    seq: number;
+}
+export interface EarlyFrame {
+    event?: string;
+    type?: string;
+    sub_id?: string;
+    id?: string;
+    cursor?: EarlyCursor;
+    data?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface EarlyStreamOptions {
+    /** Existing non-expiring token, fetched on every connect; never rotate here. */
+    getToken: () => Promise<Pick<StreamToken, 'token' | 'early_ws_url'>>;
+    subscriptions: EarlySubscribeControl[];
+    /** Awaited in arrival order. A rejection stops delivery without committing. */
+    onFrame: (frame: EarlyFrame) => void | Promise<void>;
+    /** Diagnostic callback. Never receives credentials or raw transport errors. */
+    onStatus?: (status: Record<string, unknown>) => void;
+    /** Native browser/Node WebSocket by default; pass ws explicitly if desired. */
+    WebSocketImpl?: unknown;
+    autoReconnect?: boolean;
+    maxReconnectAttempts?: number;
+    maxAuthRetries?: number;
+    backoffMs?: number;
+    maxBackoffMs?: number;
+    controlTimeoutMs?: number;
+    maxPendingFrames?: number;
+    maxPendingBytes?: number;
+    dedupeSize?: number;
+}
+/** Managed ShredPrism early-stream client (4.1.0+). Bounded process-local
+ * recovery, per-subscription checkpoints, explicit gaps; never durable history. */
+export declare class MadeOnSolEarlyStream {
+    private readonly options;
+    private readonly states;
+    private readonly limits;
+    private socket;
+    private pending;
+    private readonly replayTimers;
+    private timer;
+    private watchdog;
+    private generation;
+    private stopped;
+    private ready;
+    private attempts;
+    private authFailures;
+    private queue;
+    private queuedFrames;
+    private queuedBytes;
+    constructor(options: EarlyStreamOptions);
+    private status;
+    getSubscriptions(): EarlySubscribeControl[];
+    getCursors(): Record<string, EarlyCursor | null>;
+    /** Explicitly skip the reported missing range; never called automatically. */
+    acceptGap(id?: string): void;
+    connect(): void;
+    close(): void;
+    private fatal;
+    private rejectPending;
+    private retry;
+    private open;
+    private disconnect;
+    private enqueue;
+    private receive;
+    private command;
+    private restore;
+    /** Await the previous control before issuing another. A rejected update keeps
+     * the accepted configuration, including across reconnect. */
+    updateSubscription(id: string, change: {
+        filters?: EarlyStreamFilters;
+        format?: EarlyEventFormat;
+        wallet_list?: string | null;
+    }): Promise<void>;
+    /** Configure with subscriptions: [] to manage lists before adding a stream. */
+    manageWalletList(control: EarlyWalletListControl): Promise<EarlyWalletListResult>;
+    subscribe(raw: EarlySubscribeControl): Promise<void>;
+    unsubscribe(id?: string): Promise<void>;
+}
+//# sourceMappingURL=early-stream.d.ts.map

package/dist/early-stream.d.ts.map

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