madeonsol-x402 4.0.0 → 4.2.0

package/README.md

@@ -1,6 +1,18 @@
 # madeonsol-x402
 
-> **Unreleased ShredPrism migration (PR #420):** sniper becomes ULTRA/BUSINESS/ENTERPRISE API-key only. The keyless sniper route returns HTTP 410 without a new payment. Early observations are not proof of execution. The changes below describe the release candidate; package publication and source activation are still pending. Historical release notes describe earlier behavior.
+
+> **Agent Gateway and x402:** Current versions of this SDK support the existing
+> documented keyed and keyless data routes. The new six-tool Agent Intelligence
+> Gateway is a separate coordinated release, **not an automatically priced
+> client method**. A paid composite requires a real route in the source-of-truth
+> price catalog, exact Solana-USDC payment terms and same-proof paid-result
+> recovery. For sustained agent activity, use the appropriate API subscription
+> and preserve each underlying source's tier. See
+> [Gateway contract](../../docs/agent-gateway.md) and
+> [content/package release checklist](../../docs/runbooks/agent-gateway-content-release.md).
+
+
+> **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 cover the complete six-family wire contract: `EarlyObservationBase`, per-family deploy/trade/liquidity/migration/lock/token-change observation data, `EarlyOutcomeData`, plus `EarlyChannel`, filters, controls and private-list types; `StreamToken.early_stream` gains the six channel names and `coverage`. Released channels are `early:deploys`, `early:locks`, `early:trades`, `early:liquidity`, `early:migrations`, and `early:token_changes`. 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)
@@ -16,7 +28,7 @@ TypeScript SDK for the [MadeOnSol](https://madeonsol.com) Solana KOL intelligenc
 
 > Real-time Solana trading intelligence: track 2,000+ KOL wallets with <3s latency on paid keys and x402 pay-per-call (free-tier live feeds are 5-min delayed), score 85K+ Pump.fun deployers, surface deshred deploy signals ~500ms before on-chain confirmation, score 1.5M+ early-buyer wallets (incl. dump-cluster detection), read bundle-cohort holdings (`held_pct_of_supply` — are the bundlers still holding?), verify any wallet's current on-chain holdings (with airdrop/insider `transfer_delta` detection), push every pump.fun graduation, and stream every DEX trade. Free tier: 200 requests/day across 40+ endpoints (live feeds 5-min delayed) — no signup payment. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 
-> **Server update 2026-10-05 (no package change needed): realtime developer activity and USDC/USDT trade sizing.** The webhook event `dev:activity` (PRO+) and, on the Ultra DEX firehose socket, `dev_subscribe` → `dev:activity` + `dev:activity_enrichment` (same `id`) now deliver a token developer's `dev_sell`, `dev_buy`, `dev_token_transfer_out` and `dev_token_transfer_in` as they happen (a transfer is never a sell; PRO gets the developer's own events without identity fields; transfer coverage is partial, see `transfer_watch_coverage`). On `dex:trades`, a swap paid in USDC or USDT now carries `sol_amount` = the SOL equivalent of its stable leg (used by `dust`, `min_sol`, `max_sol`) plus the additive fields `sol_amount_basis` (`native_sol` | `stable_quote_equivalent` | `stable_quote_unconverted`) and `stable_quote`; `stable_quote_unconverted` means `sol_amount` 0 (size unknown). Details: [changelog](https://madeonsol.com/changelog).
+> **Server update 2026-10-05/08: realtime developer activity and USDC/USDT trade sizing.** The webhook event `dev:activity` (PRO+) and ULTRA+ DEX-socket `dev_subscribe` deliver `dev_sell`, `dev_buy`, `dev_token_transfer_out` and `dev_token_transfer_in` (a transfer is never a sell; PRO gets direct-developer events without identity stitching). Transfers now combine the legacy bounded wallet watch with the broad SPL Token/Token-2022 candidate source for attributed creators; `transfer_watch_coverage` describes the legacy watch only, while `transfer_sources.broad` reports the broad source's state/gaps. Recovered broad-source rows are REST history only, not retroactive realtime alerts. On `dex:trades`, a swap paid in USDC or USDT now carries `sol_amount` = the SOL equivalent of its stable leg (used by `dust`, `min_sol`, `max_sol`) plus the additive fields `sol_amount_basis` (`native_sol` | `stable_quote_equivalent` | `stable_quote_unconverted`) and `stable_quote`; `stable_quote_unconverted` means `sol_amount` 0 (size unknown). Details: [changelog](https://madeonsol.com/changelog).
 
 > **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.
 
@@ -24,7 +36,7 @@ TypeScript SDK for the [MadeOnSol](https://madeonsol.com) Solana KOL intelligenc
 
 > **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.
+> **Deployer activity timeline (server-expanded 2026-10-08).** `client.deployerActivity(wallet, { limit?, cursor?, since?, types? })` binds `GET /deployer-hunter/{wallet}/activity`: launches, `dev_buy`, `dev_sell`, `dev_token_transfer_out`, `dev_token_transfer_in`, creator transfers, fee claims, funding in and capital out, newest first. Realtime dev rows come from persisted `dev_exit_events`; recovered transfer rows can carry `recovered`, `recovered_at`, `time_basis: "chain"`, `late_classified` and `counterparty_count`. Read `coverage.families.*`, retention boundaries and the history plan before interpreting an empty range; transfer history has a shorter online retention than trade history. PRO+, keyed (v1) only.
 
 > **New in 3.1.0 (types and docs only, no runtime change):** `DeployerProfile.first_deploy_at` (earliest deploy observed by MadeOnSol) and `DeployerProfileResponse.capital_intelligence` (PRO+) are typed; REST-only parameters are documented as rejected on the x402 route with `400 param_not_supported_on_x402` before any payment (they were documented as ignored); `DeployerTokensParams.only_bonded` is documented as applied.
 
@@ -643,3 +655,164 @@ Docs: [madeonsol.com/solana-api](https://madeonsol.com/solana-api)
 | 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, the dated customer benchmark by channel (processed and confirmed references) and local
+development benchmarks, with raw downloads and methodology:
+https://madeonsol.com/solutions/shredprism-stream#benchmark-by-channel. Dated measurements from one
+client, not 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,CAe3D"}

package/dist/early-codec.js

@@ -0,0 +1,44 @@
+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 input = frame.data;
+    const data = {};
+    for (const k of Object.keys(input)) {
+        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: input[k], enumerable: true, writable: true, configurable: true });
+        else
+            data[key] = input[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, EarlyObservationData, EarlyOutcomeData, StreamToken } from './types.js';
+export { expandEarlyFrame } from './early-codec.js';
+export type { EarlyChannel, EarlyAmountField, EarlyAmountFilter, EarlyStreamFilters, EarlyEventFormat, EarlySubscribeControl, EarlyUpdateControl, EarlyObservationBase, EarlyWalletLabel, EarlyDeployObservationData, EarlyTradeObservationData, EarlyLiquidityObservationData, EarlyMigrationObservationData, EarlyLockSchedule, EarlyLockObservationData, EarlyTokenChangeObservationData, EarlyObservationData, EarlyOutcomeData } 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?: EarlyObservationData | EarlyOutcomeData | 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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"}