phantasma-sdk-ts 0.9.2 → 0.10.0

package/dist/types/link/v5/envelope.d.ts

@@ -0,0 +1,48 @@
+import { PLV } from './protocol.js';
+import { LinkErrorObject } from './errors.js';
+/** Request: dApp -> wallet. `session` is omitted only on the first `pha_connect`. */
+export interface LinkRequest {
+    plv: typeof PLV;
+    id: string;
+    session?: string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** Success response: wallet -> dApp. */
+export interface LinkSuccessResponse {
+    plv: typeof PLV;
+    id: string;
+    result: unknown;
+}
+/** Error response: wallet -> dApp. */
+export interface LinkErrorResponse {
+    plv: typeof PLV;
+    id: string;
+    error: LinkErrorObject;
+}
+export type LinkResponse = LinkSuccessResponse | LinkErrorResponse;
+/** Event: wallet -> dApp, no reply expected (spec §9.5; persistent transports only). */
+export interface LinkEventMessage {
+    plv: typeof PLV;
+    type: 'event';
+    session?: string;
+    event: string;
+    data?: unknown;
+}
+export type LinkMessage = LinkRequest | LinkResponse | LinkEventMessage;
+export declare function isLinkRequest(msg: LinkMessage): msg is LinkRequest;
+export declare function isLinkEvent(msg: LinkMessage): msg is LinkEventMessage;
+export declare function isLinkErrorResponse(msg: LinkMessage): msg is LinkErrorResponse;
+export declare function isLinkSuccessResponse(msg: LinkMessage): msg is LinkSuccessResponse;
+/** Serialize an envelope to its on-the-wire JSON text. */
+export declare function encodeEnvelope(message: LinkMessage): string;
+/**
+ * Parse and validate an on-the-wire JSON text into a {@link LinkMessage}.
+ *
+ * Throws {@link LinkError} with `ParseError` for non-JSON and `InvalidRequest` for a JSON
+ * value that is not a well-formed v5 envelope (wrong `plv`, missing `id`, or a shape that
+ * is neither request, response, nor event). Validation happens here, once, so every
+ * downstream consumer can trust the structure.
+ */
+export declare function decodeEnvelope(text: string): LinkMessage;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/types/link/v5/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/envelope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAA4B,eAAe,EAAE,MAAM,aAAa,CAAC;AAExE,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEnE,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAExE,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,GAAG,IAAI,WAAW,CAElE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,GAAG,IAAI,gBAAgB,CAErE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,GAAG,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,GAAG,IAAI,mBAAmB,CAElF;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CA8CxD"}

package/dist/types/link/v5/errors.d.ts

@@ -0,0 +1,39 @@
+/** Numeric error codes. JSON-RPC reserved range + EIP-1193-aligned app codes + Phantasma
+ * specific codes. Carried in {@link LinkErrorObject.code}. */
+export declare const LinkErrorCode: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    readonly UserRejected: 4001;
+    readonly Unauthorized: 4100;
+    readonly Disconnected: 4900;
+    readonly UnsupportedChain: 4902;
+    readonly PayloadTooLarge: 5001;
+    readonly NexusMismatch: 5002;
+    readonly UnsupportedSignatureKind: 5003;
+    readonly CapabilityNotSupported: 5004;
+    readonly SessionExpired: 5100;
+    readonly SessionRevoked: 5101;
+};
+export type LinkErrorCode = (typeof LinkErrorCode)[keyof typeof LinkErrorCode];
+/** The `error` member of an error response envelope (spec §4). */
+export interface LinkErrorObject {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/** Error thrown by the v5 client and carried over the wire as {@link LinkErrorObject}.
+ * Keeping a dedicated class lets callers branch on the numeric `code` instead of parsing
+ * message text. */
+export declare class LinkError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+    toObject(): LinkErrorObject;
+    /** Reconstruct a {@link LinkError} from a received error object, tolerating malformed
+     * inputs (a peer may send a non-conforming shape). */
+    static fromObject(obj: unknown): LinkError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/link/v5/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/errors.ts"],"names":[],"mappings":"AAGA;8DAC8D;AAC9D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;CAmBhB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;mBAEmB;AACnB,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IASzD,QAAQ,IAAI,eAAe;IAO3B;0DACsD;IACtD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS;CAY3C"}

package/dist/types/link/v5/index.d.ts

@@ -0,0 +1,15 @@
+export * from './protocol.js';
+export * from './errors.js';
+export * from './encoding.js';
+export * from './envelope.js';
+export * from './capabilities.js';
+export * from './methods.js';
+export * from './session-crypto.js';
+export * from './pairing.js';
+export * from './transport.js';
+export * from './loopback-transport.js';
+export * from './deeplink.js';
+export * from './relay-transport.js';
+export * from './web-deeplink.js';
+export * from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/link/v5/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/index.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/types/link/v5/loopback-transport.d.ts

@@ -0,0 +1,43 @@
+import { LinkTransport } from './transport.js';
+/** Minimal WebSocket surface the transport needs - satisfied by the browser `WebSocket`,
+ * the Node `ws` package, or a test double. */
+export interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    onopen: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+    onclose: ((event: {
+        reason?: string;
+        wasClean?: boolean;
+    }) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+}
+export type WebSocketFactory = (url: string) => WebSocketLike;
+export interface LoopbackTransportOptions {
+    /** Default `localhost`. */
+    host?: string;
+    /** Default `7090` (the wallet link port). */
+    port?: number;
+    /** Default `/phantasma/v5` (separate from the legacy `/phantasma`). */
+    path?: string;
+    /** Override the WebSocket implementation (Node / tests). Defaults to global `WebSocket`. */
+    webSocketFactory?: WebSocketFactory;
+}
+/** A {@link LinkTransport} over a local WebSocket to the wallet. Sends are buffered until the
+ * socket opens, then flushed, so callers can issue requests immediately after construction. */
+export declare class LoopbackTransport implements LinkTransport {
+    private readonly socket;
+    private messageHandler?;
+    private closeHandler?;
+    private readonly outbox;
+    private isOpen;
+    constructor(options?: LoopbackTransportOptions);
+    send(frame: string): void;
+    onMessage(handler: (frame: string) => void): void;
+    onClose(handler: (reason?: string) => void): void;
+    close(): void;
+}
+//# sourceMappingURL=loopback-transport.d.ts.map

package/dist/types/link/v5/loopback-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback-transport.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/loopback-transport.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C;8CAC8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3E,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;AAE9D,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAaD;+FAC+F;AAC/F,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,OAAO,CAAC,YAAY,CAAC,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,wBAA6B;IA4BlD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQzB,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjD,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjD,KAAK,IAAI,IAAI;CAOd"}

package/dist/types/link/v5/methods.d.ts

@@ -0,0 +1,83 @@
+import { ProofOfWork } from '../interfaces/proof-of-work.js';
+import { TxFormat, SignatureKind } from './protocol.js';
+import { LinkAccountV5, WalletInfo } from './capabilities.js';
+export type Base64 = string;
+/** {@link LinkMethod.Disconnect}: idempotent - closing an unknown session still succeeds. */
+export type DisconnectParams = Record<string, never>;
+export interface DisconnectResult {
+    ok: true;
+}
+/** {@link LinkMethod.GetAccounts}: only the account(s) authorized for THIS session. */
+export type GetAccountsParams = Record<string, never>;
+export interface GetAccountsResult {
+    accounts: LinkAccountV5[];
+}
+/** {@link LinkMethod.GetChains}. */
+export type GetChainsParams = Record<string, never>;
+export interface GetChainsResult {
+    /** Supported chains as CAIP-2-like ids. */
+    chains: string[];
+    /** Currently selected chain id. */
+    current: string;
+    /** The Phantasma nexus name (domain term kept as a field). */
+    nexus: string;
+}
+/** {@link LinkMethod.GetWalletInfo}. */
+export type GetWalletInfoParams = Record<string, never>;
+export type GetWalletInfoResult = WalletInfo;
+/** {@link LinkMethod.SignMessage}: non-transaction-forgeable (spec §8). */
+export interface SignMessageParams {
+    /** The message bytes to sign, base64. */
+    message: Base64;
+    /** Optional human-readable hint the wallet may show instead of raw bytes. */
+    display?: string;
+    signatureKind?: SignatureKind;
+}
+export interface SignMessageResult {
+    /** The signature, base64. */
+    signature: Base64;
+    /** The 32 random bytes the wallet prepended (base64); needed to reconstruct the signed
+     * payload `DOMAIN_TAG || random || message` for verification. */
+    random: Base64;
+}
+/** Common fields for the two transaction methods. `format` selects the RPC endpoint
+ * (spec §9.4); `pow` is meaningful only for `format: "script"` (spec §9.5). */
+export interface TransactionParams {
+    format: TxFormat;
+    /** The serialized (unsigned) transaction bytes, base64. */
+    tx: Base64;
+    signatureKind?: SignatureKind;
+    pow?: ProofOfWork;
+}
+/** {@link LinkMethod.SignTransaction}: sign only, return the assembled signed tx. */
+export type SignTransactionParams = TransactionParams;
+export interface SignTransactionResult {
+    /** The signed transaction bytes, base64; the dApp broadcasts it itself. */
+    signedTx: Base64;
+}
+/** {@link LinkMethod.SendTransaction}: sign AND broadcast via the format's RPC endpoint. */
+export type SendTransactionParams = TransactionParams;
+export interface SendTransactionResult {
+    /** The broadcast transaction hash. */
+    hash: string;
+}
+/** {@link LinkMethod.InvokeScript}: read-only VM invoke (no keys, no approval). */
+export interface InvokeScriptParams {
+    chain: string;
+    /** The raw VM script bytes, base64. */
+    script: Base64;
+}
+export interface InvokeScriptResult {
+    /** Decoded VM result objects (hex/encoded values, as the node returns them). */
+    results: string[];
+}
+export interface AccountsChangedData {
+    accounts: LinkAccountV5[];
+}
+export interface ChainChangedData {
+    chain: string;
+}
+export interface SessionLifecycleData {
+    session: string;
+}
+//# sourceMappingURL=methods.d.ts.map

package/dist/types/link/v5/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/methods.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAI5B,6FAA6F;AAC7F,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACrD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;CACV;AAED,uFAAuF;AACvF,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,oCAAoC;AACpC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACpD,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACxD,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE7C,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AACD,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB;qEACiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;+EAC+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,QAAQ,CAAC;IACjB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AACtD,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4FAA4F;AAC5F,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AACtD,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AACD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/link/v5/pairing.d.ts

@@ -0,0 +1,37 @@
+import { DappMetadata } from './capabilities.js';
+export type PairingMode = 'sym' | 'ecdh';
+/** Parsed pairing material. */
+export interface PairingParams {
+    version: number;
+    topic: string;
+    relay?: string;
+    mode: PairingMode;
+    /** Present when `mode === 'sym'`. */
+    symKey?: Uint8Array;
+    /** Present when `mode === 'ecdh'`. */
+    dappPublicKey?: Uint8Array;
+    /** Where the wallet opens response deeplinks for this pairing (spec §17). */
+    callback?: string;
+    meta?: DappMetadata;
+}
+/** Input to {@link buildPairingUri}. */
+export interface BuildPairingUriInput {
+    topic: string;
+    mode: PairingMode;
+    symKey?: Uint8Array;
+    dappPublicKey?: Uint8Array;
+    relay?: string;
+    /** dApp URL the wallet opens to deliver deeplink responses (required for deeplink use). */
+    callback?: string;
+    meta?: DappMetadata;
+    /** `universal` (default) => `https://<host>/v5/pair`; `scheme` => `phantasma://v5/pair`. */
+    scheme?: 'universal' | 'scheme';
+    /** Universal-link host; defaults to {@link DEFAULT_LINK_HOST}. */
+    host?: string;
+}
+/** Build a pairing URI. Enforces the security rule that a symmetric key (a secret) must
+ * NOT be placed in a hijackable custom-scheme URL (spec §15/§18). */
+export declare function buildPairingUri(input: BuildPairingUriInput): string;
+/** Parse a pairing URI (universal-link or custom-scheme) into {@link PairingParams}. */
+export declare function parsePairingUri(uri: string): PairingParams;
+//# sourceMappingURL=pairing.d.ts.map

package/dist/types/link/v5/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/pairing.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzC,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,sCAAsC;IACtC,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;qEACqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CA0CnE;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAkD1D"}

package/dist/types/link/v5/protocol.d.ts

@@ -0,0 +1,60 @@
+/** Protocol version carried in every v5 envelope (`plv`). A peer that does not recognize
+ * this value rejects the message with {@link LinkErrorCode.InvalidRequest}. */
+export declare const PLV: 5;
+/** Default subdomain that hosts the universal links + AASA/assetlinks + relay (spec §17).
+ * NEVER `phantasma.io` (hostile). */
+export declare const DEFAULT_LINK_HOST = "link.phantasma.info";
+/** Request methods (dApp -> wallet). Namespaced `pha_*`, EIP-1193-aligned (spec §9). */
+export declare const LinkMethod: {
+    /** Pair or resume a session; returns the capability handshake + account + session. */
+    readonly Connect: "pha_connect";
+    /** End the session. */
+    readonly Disconnect: "pha_disconnect";
+    /** Account(s) authorized for this session. */
+    readonly GetAccounts: "pha_getAccounts";
+    /** Supported chains (CAIP-2) + current; `nexus` as a field. */
+    readonly GetChains: "pha_getChains";
+    /** Wallet name/version/capabilities/rpc. */
+    readonly GetWalletInfo: "pha_getWalletInfo";
+    /** Sign an arbitrary, non-transaction-forgeable message. */
+    readonly SignMessage: "pha_signMessage";
+    /** Sign a transaction only (do NOT broadcast); the dApp submits it. */
+    readonly SignTransaction: "pha_signTransaction";
+    /** Sign AND broadcast a transaction via the format's RPC endpoint. */
+    readonly SendTransaction: "pha_sendTransaction";
+    /** Read-only VM invoke (no keys, no approval). */
+    readonly InvokeScript: "pha_invokeScript";
+};
+export type LinkMethod = (typeof LinkMethod)[keyof typeof LinkMethod];
+/** Event names pushed wallet -> dApp on a persistent transport (spec §9.5 events caveat). */
+export declare const LinkEvent: {
+    readonly AccountsChanged: "pha_accountsChanged";
+    readonly ChainChanged: "pha_chainChanged";
+    readonly SessionDeleted: "pha_sessionDeleted";
+    readonly SessionExpired: "pha_sessionExpired";
+    /** Unsolicited connect result pushed right after a pairing approval (spec §15 step 3),
+     * letting the first connection complete in one user gesture. Unlike the other events it
+     * also rides the deeplink transport: the wallet is foreground at the approval moment, so
+     * it CAN open the callback (this is a reply to the pairing, not a spontaneous push).
+     * `data` carries the same shape as a `pha_connect` result. */
+    readonly SessionEstablished: "pha_sessionEstablished";
+};
+export type LinkEvent = (typeof LinkEvent)[keyof typeof LinkEvent];
+/** Transaction serialization format. Selects which RPC submission endpoint the wallet uses
+ * (spec §9.4): `script` -> SendRawTransaction (classic `Transaction`), `carbon` ->
+ * SendCarbonTransaction (Carbon `SignedTxMsg`). Routing is by serialization envelope, NOT
+ * by "contains a script" (a Carbon tx may also wrap a script). */
+export declare const TxFormat: {
+    readonly Script: "script";
+    readonly Carbon: "carbon";
+};
+export type TxFormat = (typeof TxFormat)[keyof typeof TxFormat];
+/** Signature scheme used to sign a Phantasma payload (spec §9.7). Selects the key:
+ * `Ed25519` = the Phantasma key, `ECDSA` = the secp256k1 (ETH/BSC-interop) key. This is
+ * NOT native foreign-chain signing - the wallet always targets Phantasma. */
+export declare const SignatureKind: {
+    readonly Ed25519: "Ed25519";
+    readonly ECDSA: "ECDSA";
+};
+export type SignatureKind = (typeof SignatureKind)[keyof typeof SignatureKind];
+//# sourceMappingURL=protocol.d.ts.map

package/dist/types/link/v5/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/protocol.ts"],"names":[],"mappings":"AAIA;+EAC+E;AAC/E,eAAO,MAAM,GAAG,EAAG,CAAU,CAAC;AAE9B;qCACqC;AACrC,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD,wFAAwF;AACxF,eAAO,MAAM,UAAU;IACrB,sFAAsF;;IAEtF,uBAAuB;;IAEvB,8CAA8C;;IAE9C,+DAA+D;;IAE/D,4CAA4C;;IAE5C,4DAA4D;;IAE5D,uEAAuE;;IAEvE,sEAAsE;;IAEtE,kDAAkD;;CAE1C,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,6FAA6F;AAC7F,eAAO,MAAM,SAAS;;;;;IAKpB;;;;kEAI8D;;CAEtD,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE;;;kEAGkE;AAClE,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE;;6EAE6E;AAC7E,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/dist/types/link/v5/relay-transport.d.ts

@@ -0,0 +1,73 @@
+import { LinkTransport } from './transport.js';
+import { WebSocketFactory } from './loopback-transport.js';
+/** Default relay endpoint on the universal-link host (spec §17). */
+export declare const DEFAULT_RELAY_URL = "wss://link.phantasma.info/relay";
+/** Outgoing chunk threshold. The relay caps a whole frame at 1 MiB; this leaves room
+ * for the publish envelope around the payload. */
+export declare const RELAY_CHUNK_BYTES = 900000;
+export interface RelayTransportOptions {
+    /** The pairing topic both sides subscribe to (bearer capability, spec §16). */
+    topic: string;
+    /** Relay WebSocket URL; default {@link DEFAULT_RELAY_URL}. */
+    url?: string;
+    /** Override the WebSocket implementation (Node / tests). Defaults to global WebSocket. */
+    webSocketFactory?: WebSocketFactory;
+    /** Chunking threshold for outgoing frames; default {@link RELAY_CHUNK_BYTES}. */
+    maxPayloadBytes?: number;
+    /** Ceiling for one reassembled incoming message; default 64 MB of frame text. */
+    maxAssembledBytes?: number;
+    /** How long to wait for the relay's ack of one publish; default 15 s. */
+    publishAckTimeoutMs?: number;
+    /** Reconnect backoff ladder; the last entry repeats. Default 0.5/1/2/5/15 s. */
+    reconnectDelaysMs?: number[];
+    /** ecdh pairing (spec §18.1): called ONCE with the wallet's ephemeral X25519 public key
+     * (base64url) when the key hop arrives; the caller derives the session key before any
+     * sealed frame embedded in the same payload is forwarded. */
+    onWalletKey?: (publicKeyB64Url: string) => void;
+    /** Optional sink for diagnostics the transport cannot attribute to a caller - notably relay
+     * `error` frames that match no in-flight publish (spec §16: clients MUST surface error frames,
+     * not drop them). Defaults to console.warn; wire this to redirect or silence. */
+    log?: (message: string) => void;
+}
+/**
+ * {@link LinkTransport} over the Phantasma Link relay. `send` resolves once the relay
+ * acknowledged the publish (or rejects on timeout/close); incoming `deliver` frames are
+ * surfaced to the session client after chunk reassembly. Transient socket drops are
+ * absorbed by reconnection - the session layer only learns about an explicit close().
+ */
+export declare class RelayTransport implements LinkTransport {
+    private readonly topic;
+    private readonly url;
+    private readonly factory;
+    private readonly maxPayloadBytes;
+    private readonly maxAssembledBytes;
+    private readonly publishAckTimeoutMs;
+    private readonly reconnectDelaysMs;
+    private socket?;
+    private messageHandler?;
+    private closeHandler?;
+    private readonly onWalletKey?;
+    private readonly log?;
+    private walletKeySeen;
+    private readonly pending;
+    private readonly partials;
+    private publishSeq;
+    private reconnectAttempt;
+    private reconnectTimer?;
+    private closed;
+    constructor(options: RelayTransportOptions);
+    send(frame: string): Promise<void>;
+    onMessage(handler: (frame: string) => void): void;
+    onClose(handler: (reason?: string) => void): void;
+    close(): void;
+    private connect;
+    private scheduleReconnect;
+    private publish;
+    private rejectAllPending;
+    private handleRaw;
+    /** Collect one chunk; emit the reassembled frame when complete. Bounds: chunk count,
+     * total bytes, concurrent partial messages, and a staleness GC - a hostile peer can
+     * waste its own topic, but not this client's memory (spec §16). */
+    private acceptChunk;
+}
+//# sourceMappingURL=relay-transport.d.ts.map

package/dist/types/link/v5/relay-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-transport.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/relay-transport.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAiB,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG1E,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,oCAAqC,CAAC;AAEpE;kDACkD;AAClD,eAAO,MAAM,iBAAiB,SAAU,CAAC;AAQzC,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;iEAE6D;IAC7D,WAAW,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD;;qFAEiF;IACjF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AA4BD;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAW;IAE7C,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,OAAO,CAAC,YAAY,CAAC,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAoC;IACjE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAA4B;IACjD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAC,CAAgC;IACvD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,qBAAqB;IAgBpC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxC,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjD,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjD,KAAK,IAAI,IAAI;IAqBb,OAAO,CAAC,OAAO;IAsCf,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,SAAS;IA2EjB;;uEAEmE;IACnE,OAAO,CAAC,WAAW;CAwDpB"}

package/dist/types/link/v5/session-crypto.d.ts

@@ -0,0 +1,51 @@
+/** Session/channel key length (32 bytes). */
+export declare const SESSION_KEY_LENGTH: number;
+/** Per-message nonce length (24 bytes). */
+export declare const NONCE_LENGTH: number;
+/** X25519 public-key length (32 bytes). */
+export declare const PUBLIC_KEY_LENGTH: number;
+/** Domain separator prepended before signing a message. It can never be the prefix of a
+ * valid serialized Phantasma transaction, so a `signMessage` signature can never be
+ * replayed as a transaction signature (spec §8). */
+export declare const SIGN_MESSAGE_DOMAIN_TAG: Uint8Array;
+/** Length of the CSPRNG random the wallet prepends in `signMessage` (spec §8). */
+export declare const SIGN_MESSAGE_RANDOM_LENGTH = 32;
+/** An encrypted, on-the-wire frame: the nonce + ciphertext, both base64. */
+export interface EncryptedFrame {
+    nonce: string;
+    ct: string;
+}
+/** An X25519 keypair for the custom-scheme ECDH pairing path. */
+export interface EphemeralKeyPair {
+    publicKey: Uint8Array;
+    secretKey: Uint8Array;
+}
+/** Generate a fresh 32-byte symmetric session key (primary universal-link / QR path). */
+export declare function generateSessionKey(): Uint8Array;
+/** Generate a random url-safe token (default 16 bytes), used for request `id`s and pairing
+ * topics. Crypto-random so ids are unguessable as well as unique. */
+export declare function randomToken(byteLength?: number): string;
+/** Generate an ephemeral X25519 keypair (custom-scheme ECDH fallback path). */
+export declare function generateEphemeralKeyPair(): EphemeralKeyPair;
+/** Derive the 32-byte session key from the peer's X25519 public key and our secret key
+ * (ECDH; NaCl `box.before`). The result is directly usable as a `secretbox` key. */
+export declare function deriveSessionKey(theirPublicKey: Uint8Array, mySecretKey: Uint8Array): Uint8Array;
+/** Encrypt arbitrary plaintext bytes into a frame with a fresh random nonce. */
+export declare function seal(plaintext: Uint8Array, key: Uint8Array): EncryptedFrame;
+/** Decrypt a frame back to plaintext bytes. Throws on any tampering/wrong-key (authenticated
+ * encryption: `secretbox.open` returns null, which we surface as an error). */
+export declare function open(frame: EncryptedFrame, key: Uint8Array): Uint8Array;
+/** Encrypt an envelope's JSON text into a frame. */
+export declare function sealEnvelopeText(json: string, key: Uint8Array): EncryptedFrame;
+/** Decrypt a frame back into the envelope's JSON text. */
+export declare function openEnvelopeText(frame: EncryptedFrame, key: Uint8Array): string;
+/** Generate the 32 random bytes a wallet prepends in `signMessage`. */
+export declare function generateSignMessageRandom(): Uint8Array;
+/**
+ * Build the exact byte string a wallet signs for `pha_signMessage`:
+ * `DOMAIN_TAG || random || message` (spec §8). A verifier reconstructs the same bytes from
+ * the returned `random` + the original `message`. Keeping this in one place guarantees the
+ * wallet and any verifier agree on the layout.
+ */
+export declare function buildSignMessagePayload(message: Uint8Array, random: Uint8Array): Uint8Array;
+//# sourceMappingURL=session-crypto.d.ts.map

package/dist/types/link/v5/session-crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-crypto.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/session-crypto.ts"],"names":[],"mappings":"AAuBA,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,QAA2B,CAAC;AAC3D,2CAA2C;AAC3C,eAAO,MAAM,YAAY,QAA6B,CAAC;AACvD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,QAA2B,CAAC;AAE1D;;oDAEoD;AACpD,eAAO,MAAM,uBAAuB,EAAE,UAAmD,CAAC;AAC1F,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;CACvB;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED;qEACqE;AACrE,wBAAgB,WAAW,CAAC,UAAU,SAAK,GAAG,MAAM,CAEnD;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,IAAI,gBAAgB,CAG3D;AAED;oFACoF;AACpF,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,GAAG,UAAU,CAKhG;AAQD,gFAAgF;AAChF,wBAAgB,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,cAAc,CAK3E;AAED;+EAC+E;AAC/E,wBAAgB,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,GAAG,UAAU,CAYvE;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,cAAc,CAE9E;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,CAE/E;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,IAAI,UAAU,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAY3F"}

package/dist/types/link/v5/transport.d.ts

@@ -0,0 +1,77 @@
+/** A duplex channel that carries opaque frame strings between dApp and wallet. */
+export interface LinkTransport {
+    send(frame: string): void | Promise<void>;
+    onMessage(handler: (frame: string) => void): void;
+    onClose?(handler: (reason?: string) => void): void;
+    close(): void;
+}
+export type LinkEventHandler = (event: string, data: unknown, session?: string) => void;
+export interface LinkSessionClientOptions {
+    /** 32-byte session key. When omitted, frames are PLAINTEXT envelope JSON - appropriate
+     * ONLY for a trusted local transport (loopback/injected); deeplink and relay MUST set a
+     * key (spec §8). */
+    sessionKey?: Uint8Array;
+    /** Refuse to SEND until a session key is set (see {@link LinkSessionClient.setSessionKey}).
+     * Used by the ecdh pairing flow, where the key is derived only after the wallet's
+     * public key arrives - plaintext must never leave the client in the meantime. */
+    requireSessionKey?: boolean;
+    /** Session id attached to outgoing requests after connect/pairing. */
+    sessionId?: string;
+    /** Per-request timeout in ms; 0 disables. Default 60000. */
+    requestTimeoutMs?: number;
+    /** Sink for responses with no matching in-flight request (the deeplink page reloaded while
+     * the wallet was open, discarding the original request promise). Without it such responses
+     * are dropped. Never fires on same-page flows - those always have a pending entry. */
+    onUnmatchedResponse?: (response: UnmatchedResponse) => void;
+}
+/** A wallet response that arrived with no in-flight request to match it - the deeplink reload
+ * case, where the page that issued the request was discarded before the answer came back.
+ * Surfaced via {@link LinkSessionClientOptions.onUnmatchedResponse} so a persistence layer can
+ * still present the result instead of dropping it. */
+export interface UnmatchedResponse {
+    id: string;
+    ok: boolean;
+    result?: unknown;
+    error?: unknown;
+}
+/**
+ * Drives a v5 session over a {@link LinkTransport}. `request()` sends a typed envelope and
+ * resolves with the wallet's `result` (or rejects with a {@link LinkError}); incoming events
+ * are dispatched to {@link onEvent} handlers. Encryption is transparent: when a session key
+ * is set, every outgoing envelope is sealed and every incoming frame is opened.
+ */
+export declare class LinkSessionClient {
+    private readonly transport;
+    private sessionKey?;
+    private readonly requireSessionKey;
+    private sessionId?;
+    private readonly requestTimeoutMs;
+    private readonly onUnmatchedResponse?;
+    private readonly pending;
+    private readonly eventHandlers;
+    private closed;
+    constructor(transport: LinkTransport, options?: LinkSessionClientOptions);
+    /** Set/refresh the session id sent on subsequent requests (e.g. after `pha_connect`),
+     * or clear it with `undefined` (e.g. after `pha_disconnect`). */
+    setSessionId(id: string | undefined): void;
+    /** The current session id, if a session is established. */
+    getSessionId(): string | undefined;
+    /** Install the channel key once it is established (ecdh pairing derives it only after
+     * the wallet's ephemeral public key arrives, spec §18.1). From here on every frame is
+     * sealed/opened with it, exactly as if it had been passed at construction. */
+    setSessionKey(key: Uint8Array): void;
+    /** Subscribe to wallet->dApp events; returns an unsubscribe function. */
+    onEvent(handler: LinkEventHandler): () => void;
+    /** Send a request and await its result. Rejects with {@link LinkError}. */
+    request(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** Close the session, rejecting all in-flight requests. */
+    close(): void;
+    private encodeOutgoing;
+    private decodeIncoming;
+    private handleFrame;
+    private emitEvent;
+    private handleClose;
+    private settleError;
+    private rejectAll;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/types/link/v5/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/transport.ts"],"names":[],"mappings":"AA0BA,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAClD,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAExF,MAAM,WAAW,wBAAwB;IACvC;;wBAEoB;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;qFAEiF;IACjF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;0FAEsF;IACtF,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC7D;AAQD;;;sDAGsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAwC;IAC7E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAC7D,OAAO,CAAC,MAAM,CAAS;gBAEX,SAAS,EAAE,aAAa,EAAE,OAAO,GAAE,wBAA6B;IAW5E;qEACiE;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI1C,2DAA2D;IAC3D,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;kFAE8E;IAC9E,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAOpC,yEAAyE;IACzE,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAO9C,2EAA2E;IAC3E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAwD3E,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,SAAS;CASlB"}