@invisible-labs/sdk 0.6.0-devnet.3 → 0.6.0-devnet.5

package/dist/index.js

@@ -1,10 +1,10 @@
-import { createStateController, reattestSerialized } from './chunk-BWCGNTN5.js';
-export { closeSession, createExponentialBackoff, createSession, noiseWebSocketTransport, performAttestation, performNoiseHandshake } from './chunk-BWCGNTN5.js';
-export { assertAttested, hex, lamports, publicKey, requestId } from './chunk-NHEHCUS5.js';
-import { getSessionState, failSessionClosed } from './chunk-V5HXJRBW.js';
-export { assertAttestResponse, verifyAttestation } from './chunk-DIA6U2CV.js';
-import { TransportError, NotImplementedError } from './chunk-GHBQF3A7.js';
-export { AttestationError, CommandError, InvalidDepositAmountError, InvisibleError, LpLifecycleError, NotImplementedError, PolicyValidationError, RoutingError, StorageError, TransportError, WalletError, isInvisibleError, normalizeError } from './chunk-GHBQF3A7.js';
+import { createStateController, createSessionInternal, isLoopbackUrl, reattestSerialized, INTEL_SGX_ROOT_CA_FINGERPRINT_SHA256 } from './chunk-Y7AK6RBV.js';
+export { closeSession, createExponentialBackoff, noiseWebSocketTransport } from './chunk-Y7AK6RBV.js';
+export { assertAttested, hex, lamports, publicKey, requestId } from './chunk-EBWTAXNT.js';
+import { getSessionState, failSessionClosed } from './chunk-HJFMDMPY.js';
+import './chunk-DCTYBUY3.js';
+import { TransportError, NotImplementedError } from './chunk-QRN46R3F.js';
+export { AttestationError, CommandError, InvalidDepositAmountError, InvisibleError, LpLifecycleError, NotImplementedError, PolicyValidationError, RoutingError, StorageError, TransportError, WalletError, isInvisibleError, normalizeError } from './chunk-QRN46R3F.js';
 import './chunk-VR6T6OJS.js';
 
 // src/core/version.ts
@@ -51,15 +51,139 @@ function inMemoryTransport(options = {}) {
   };
 }
 
-// src/attestation/index.ts
+// src/presets/azure-prod-maa.generated.ts
+var AZURE_PROD_MAA_TRUST = {
+  issuer: "https://sharedweu.weu.attest.azure.net",
+  jwksUrl: "https://sharedweu.weu.attest.azure.net/certs",
+  policyHash: "9NY0VnTQ-IiBriBplVUpFbczcDaEBUwsiFYAzHu_gco"};
+var configuredRuntimeProfile = "prod-devnet-simplified-locked" ;
+var APPROVED_PRODUCTION_RUNTIME_PROFILE = configuredRuntimeProfile ;
+
+// src/presets/production.ts
+var AZURE_PROD_COORDINATOR_MRTD = "a2e61f1316e9e367e9c1f7a0adc98c48eb13875c399c85d286cee5ea2b05e57f2df9f61d903b0ae7ac5607d843dfffc1";
+var AZURE_PROD_RUNTIME_PROFILE = APPROVED_PRODUCTION_RUNTIME_PROFILE;
+var BINARY_HASH_HEX = /^[0-9a-f]{64}$/i;
+var MRTD_HEX = /^[0-9a-f]{96}$/i;
+var AZURE_PROD_RELEASE_PIN = {
+  mrtd: AZURE_PROD_COORDINATOR_MRTD,
+  runtimeProfile: AZURE_PROD_RUNTIME_PROFILE,
+  intelRootFingerprint: INTEL_SGX_ROOT_CA_FINGERPRINT_SHA256,
+  azureMaa: {
+    issuer: AZURE_PROD_MAA_TRUST.issuer,
+    jwksUrl: AZURE_PROD_MAA_TRUST.jwksUrl,
+    policyHash: AZURE_PROD_MAA_TRUST.policyHash
+  }
+};
+function assertApprovedBinaryHash(value) {
+  const binaryHash = typeof value === "string" ? value.toLowerCase() : "";
+  if (!BINARY_HASH_HEX.test(binaryHash)) {
+    throw new Error("an approved 64-character binary SHA-256 hash is required");
+  }
+  return binaryHash;
+}
+function assertApprovedMrtd(value) {
+  const mrtd = typeof value === "string" ? value.toLowerCase() : "";
+  if (!MRTD_HEX.test(mrtd)) {
+    throw new Error("an approved 96-character production MRTD is required");
+  }
+  return mrtd;
+}
+function createAzureProductionEndpoint({
+  wsUrl,
+  expectedHostname,
+  approvedBinaryHash,
+  approvedMrtd = AZURE_PROD_COORDINATOR_MRTD
+}) {
+  const binaryHash = assertApprovedBinaryHash(approvedBinaryHash);
+  const mrtd = assertApprovedMrtd(approvedMrtd);
+  return {
+    wsUrl,
+    expectedHostname,
+    releasePin: { ...AZURE_PROD_RELEASE_PIN, mrtd, binaryHash },
+    requiredMode: "prod"
+  };
+}
+
+// src/presets/productionBinaryHash.ts
+var APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH = "e08f16d1c303f402e8210302e85ff8ce497e4152d7511143849c7771d56a1663".toLowerCase() ;
+
+// src/presets/productionMrtd.ts
+var APPROVED_PRODUCTION_COORDINATOR_MRTD = "a2e61f1316e9e367e9c1f7a0adc98c48eb13875c399c85d286cee5ea2b05e57f2df9f61d903b0ae7ac5607d843dfffc1".toLowerCase() ;
+
+// src/session/publicReleasePolicy.ts
+function publicProductionReleasePolicy() {
+  return {
+    expectedMrtd: APPROVED_PRODUCTION_COORDINATOR_MRTD,
+    expectedBinaryHash: APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH,
+    expectedRuntimeProfile: APPROVED_PRODUCTION_RUNTIME_PROFILE
+  };
+}
+
+// src/session/publicSession.ts
+var PUBLIC_SESSION_OPTION_KEYS = /* @__PURE__ */ new Set([
+  "coordinatorUrl",
+  "storage",
+  "wallet",
+  "clientPersistence"
+]);
+var PUBLIC_COORDINATOR_URL_PROTOCOL = "wss:";
+var PUBLIC_COORDINATOR_URL_ERROR = "public SDK createSession requires a non-loopback wss:// coordinatorUrl";
+async function createSession(options) {
+  assertPublicOptions(options);
+  const parsedUrl = parsePublicCoordinatorUrl(options.coordinatorUrl);
+  const releasePolicy = publicProductionReleasePolicy();
+  const endpoint = createAzureProductionEndpoint({
+    wsUrl: options.coordinatorUrl,
+    expectedHostname: parsedUrl.hostname,
+    approvedBinaryHash: releasePolicy.expectedBinaryHash,
+    approvedMrtd: releasePolicy.expectedMrtd
+  });
+  const internalOptions = {
+    coordinator: { endpoints: [endpoint] },
+    ...options.storage === void 0 ? {} : { storage: options.storage },
+    ...options.wallet === void 0 ? {} : { wallet: options.wallet },
+    ...options.clientPersistence === void 0 ? {} : { clientPersistence: options.clientPersistence }
+  };
+  return createSessionInternal(internalOptions);
+}
+function assertPublicOptions(options) {
+  if (typeof options !== "object" || options === null || Array.isArray(options)) {
+    throw new TypeError("public SDK createSession options must be an object");
+  }
+  for (const key of Object.keys(options)) {
+    if (!PUBLIC_SESSION_OPTION_KEYS.has(key)) {
+      throw new Error(`public SDK createSession does not accept option ${key}`);
+    }
+  }
+  const coordinatorUrl = options.coordinatorUrl;
+  if (typeof coordinatorUrl !== "string") {
+    throw new TypeError("public SDK createSession requires coordinatorUrl");
+  }
+  const clientPersistence = options.clientPersistence;
+  if (clientPersistence !== void 0 && typeof clientPersistence !== "boolean") {
+    throw new TypeError("public SDK createSession clientPersistence must be a boolean");
+  }
+}
+function parsePublicCoordinatorUrl(value) {
+  let parsed;
+  try {
+    parsed = new URL(value);
+  } catch (cause) {
+    const error = new Error(PUBLIC_COORDINATOR_URL_ERROR);
+    error.cause = cause;
+    throw error;
+  }
+  if (parsed.protocol !== PUBLIC_COORDINATOR_URL_PROTOCOL || isLoopbackUrl(value)) {
+    throw new Error(PUBLIC_COORDINATOR_URL_ERROR);
+  }
+  return parsed;
+}
+
+// src/attestation/public.ts
 var attestation = {
-  /**
-   * Force-verify the current session against the active policy by re-running
-   * attestation over the live channel. Updates the stored result on success.
-   *
-   * @throws AttestationError if verification fails.
-   * @throws TransportError if the session has no live attested channel.
-   */
+  productionPolicy() {
+    return publicProductionReleasePolicy();
+  },
   async assertValid(session) {
     const state = getSessionState(session);
     const endpoint = state.pool.endpoints[0];
@@ -74,19 +198,26 @@ var attestation = {
       throw error;
     }
   },
-  /** The last verified attestation result, or `null` before first attestation. */
   current(session) {
     return getSessionState(session).attestation;
   },
-  /** The release pin the active leader endpoint is verified against. Read-only. */
   policy(session) {
-    return getSessionState(session).pool.endpoints[0].releasePin;
+    const pin = getSessionState(session).pool.endpoints[0].releasePin;
+    return {
+      expectedMrtd: pin.mrtd,
+      ...pin.binaryHash === void 0 ? {} : { expectedBinaryHash: pin.binaryHash },
+      ...pin.runtimeProfile === void 0 ? {} : { expectedRuntimeProfile: pin.runtimeProfile },
+      ...pin.runtimeMeasurements === void 0 ? {} : { expectedRuntimeMeasurements: pin.runtimeMeasurements },
+      ...pin.intelRootFingerprint === void 0 ? {} : { intelRootFingerprint: pin.intelRootFingerprint },
+      ...pin.azureMaa === void 0 ? {} : {
+        azureMaa: {
+          expectedIssuer: pin.azureMaa.issuer,
+          expectedJwksUrl: pin.azureMaa.jwksUrl,
+          expectedPolicyHash: pin.azureMaa.policyHash
+        }
+      }
+    };
   },
-  /**
-   * Subscribe to out-of-band attestation failures (e.g. during periodic
-   * re-attestation). The handler fires with the verification error; returns an
-   * unsubscribe function.
-   */
   onPolicyViolation(session, handler) {
     const handlers = getSessionState(session).policyViolationHandlers;
     handlers.add(handler);
@@ -94,39 +225,26 @@ var attestation = {
   }
 };
 
-// src/coordinator/index.ts
+// src/coordinator/public.ts
 var coordinator = {
-  /** All configured endpoints, in the order supplied. Read-only. */
   endpoints(session) {
-    return getSessionState(session).pool.endpoints;
+    return getSessionState(session).pool.endpoints.map((endpoint) => ({
+      coordinatorUrl: endpoint.wsUrl,
+      ...endpoint.roleHint === void 0 ? {} : { roleHint: endpoint.roleHint },
+      ...endpoint.weight === void 0 ? {} : { weight: endpoint.weight }
+    }));
   },
-  /**
-   * The endpoint currently accepting mutating commands.
-   *
-   * @throws NotImplementedError - deferred (coordinator-pending).
-   */
   currentLeader(_session) {
     return Promise.reject(new NotImplementedError("coordinator.currentLeader"));
   },
-  /**
-   * The coordinator-reported version snapshot.
-   *
-   * @throws NotImplementedError - deferred (coordinator-pending).
-   */
   version(_session) {
     return Promise.reject(new NotImplementedError("coordinator.version"));
   },
-  /**
-   * Tear down the active session and reconnect through the next healthy
-   * endpoint, forcing a fresh attestation.
-   *
-   * @throws NotImplementedError - deferred (coordinator-pending).
-   */
   forceFailover(_session) {
     return Promise.reject(new NotImplementedError("coordinator.forceFailover"));
   }
 };
 
-export { apiVersion, attestation, coordinator, inMemoryTransport, isAttested };
+export { apiVersion, attestation, coordinator, createSession, inMemoryTransport, isAttested };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/version.ts","../src/core/session.ts","../src/transport/inMemoryTransport.ts","../src/attestation/index.ts","../src/coordinator/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The API surface version this build implements. Bumped only on a breaking\n * surface change. See docs/sdk-specification.md section 12.\n */\nexport const apiVersion = \"v0\" as const;\n\n/** Literal type of {@link apiVersion}. */\nexport type ApiVersion = typeof apiVersion;\n","/**\n * The opaque session handle.\n *\n * A `Session` is the single stateful object the functional surface threads\n * through every call: `fn(session, args)`. It owns the transport, the\n * attestation state, and (later) the leader-epoch bookkeeping. Consumers treat\n * it as opaque - they read `session.attested` and pass it back to SDK\n * functions, but never reach inside. The internal state map and constructor\n * live alongside `createSession` (added in a later ticket); this module only\n * fixes the public shape so the rest of the surface can type against it.\n */\n\ndeclare const sessionBrand: unique symbol;\n\n/**\n * Opaque, attested session handle. Obtain one from `createSession`; pass it as\n * the first argument to every actor command. The only field consumers read is\n * {@link Session.attested}.\n */\nexport interface Session {\n  /**\n   * Whether the current Noise session has passed full TDX attestation. Sensitive\n   * commands refuse to run until this is `true`. Re-handshake or failover resets\n   * it to `false` until a fresh attestation completes.\n   */\n  readonly attested: boolean;\n  /** @internal Opacity brand; not constructable by consumers. */\n  readonly [sessionBrand]: true;\n}\n\n/** Convenience predicate mirroring {@link Session.attested}. */\nexport function isAttested(session: Session): boolean {\n  return session.attested;\n}\n","/**\n * In-memory transport.\n *\n * A zero-network channel used by unit tests. It transitions straight to `open`\n * on connect. `send` delivers the raw frame bytes to an optional peer sink: the\n * WebSocket message boundary is the frame boundary, so there is no extra length\n * prefix (matching the production transport). Noise lives above this pure byte\n * channel, never inside it.\n *\n * With no peer wired in, `send` is a silent no-op (legacy stub behaviour for\n * tests that never exchange frames). A paired loopback coordinator supplies a\n * `peer` sink so a real Noise XX handshake can run in-process (see the\n * `testLoopback` fixture).\n */\n\nimport { TransportError } from \"../core/errors.js\";\nimport { createStateController } from \"./stateController.js\";\nimport type { Transport, Unsubscribe } from \"./types.js\";\n\n/** Options for {@link inMemoryTransport}. Test-only paired-loopback wiring. */\nexport interface InMemoryTransportOptions {\n  /**\n   * Sink for frames written via `send()`. A paired in-process coordinator sets\n   * this so the client's raw bytes reach the responder. When omitted, `send`\n   * is a no-op so legacy stub-only tests keep working.\n   */\n  readonly peer?: (frame: Uint8Array) => void;\n}\n\n/** In-memory transport with a hook to feed inbound frames into `onMessage`. */\nexport interface InMemoryTransportHandle extends Transport {\n  /** Deliver a frame to this transport's `onMessage` listeners (peer -> client). */\n  readonly deliver: (frame: Uint8Array) => void;\n}\n\nexport function inMemoryTransport(options: InMemoryTransportOptions = {}): InMemoryTransportHandle {\n  const sc = createStateController(\"idle\");\n  const messageListeners = new Set<(frame: Uint8Array) => void>();\n\n  return {\n    state: () => sc.get(),\n    onStateChange: (listener) => sc.onChange(listener),\n    onMessage(listener): Unsubscribe {\n      messageListeners.add(listener);\n      return () => messageListeners.delete(listener);\n    },\n    deliver(frame: Uint8Array): void {\n      for (const listener of messageListeners) listener(frame);\n    },\n    async connect(signal) {\n      if (signal?.aborted) {\n        throw new TransportError(\"CONNECTION_LOST\", \"connect aborted before it started\");\n      }\n      if (sc.get() === \"open\") return;\n      sc.set(\"connecting\");\n      sc.set(\"open\");\n    },\n    send(frame: Uint8Array): void {\n      if (sc.get() !== \"open\") {\n        throw new TransportError(\"CONNECTION_LOST\", \"cannot send on a non-open transport\");\n      }\n      options.peer?.(frame);\n    },\n    close() {\n      if (sc.get() === \"closed\") return;\n      sc.set(\"closing\");\n      sc.set(\"closed\");\n    },\n  };\n}\n","/**\n * `attestation` - read controls and verification triggers (spec section 4.1).\n *\n * Grouped as a small object of free functions over the opaque `Session`. The\n * read accessors (`current`, `policy`) report the last verified result and the\n * active pin; `assertValid` re-runs attestation over the live channel and\n * `onPolicyViolation` subscribes to out-of-band re-attestation failures.\n */\n\nimport type { Session } from \"../core/session.js\";\nimport type { Unsubscribe } from \"../transport/types.js\";\nimport type { AttestationResult } from \"../transport/handshake.js\";\nimport type { CoordinatorReleasePin } from \"../schemas/types.generated.js\";\nimport { failSessionClosed, getSessionState } from \"../session/state.js\";\nimport { reattestSerialized } from \"./reattest.js\";\n\nexport const attestation = {\n  /**\n   * Force-verify the current session against the active policy by re-running\n   * attestation over the live channel. Updates the stored result on success.\n   *\n   * @throws AttestationError if verification fails.\n   * @throws TransportError if the session has no live attested channel.\n   */\n  async assertValid(session: Session): Promise<AttestationResult> {\n    const state = getSessionState(session);\n    const endpoint = state.pool.endpoints[0]!;\n    try {\n      const result = await reattestSerialized(state, endpoint, state.pool.noiseTransportTimeoutMs);\n      state.attestation = result;\n      state.attested = true;\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      failSessionClosed(state, error);\n      throw error;\n    }\n  },\n\n  /** The last verified attestation result, or `null` before first attestation. */\n  current(session: Session): AttestationResult | null {\n    return getSessionState(session).attestation;\n  },\n\n  /** The release pin the active leader endpoint is verified against. Read-only. */\n  policy(session: Session): CoordinatorReleasePin {\n    return getSessionState(session).pool.endpoints[0]!.releasePin;\n  },\n\n  /**\n   * Subscribe to out-of-band attestation failures (e.g. during periodic\n   * re-attestation). The handler fires with the verification error; returns an\n   * unsubscribe function.\n   */\n  onPolicyViolation(session: Session, handler: (error: Error) => void): Unsubscribe {\n    const handlers = getSessionState(session).policyViolationHandlers;\n    handlers.add(handler);\n    return () => handlers.delete(handler);\n  },\n};\n","/**\n * `coordinator` - endpoint pool inspection and failover (spec section 4.2).\n *\n * `endpoints` is a read accessor that works today. Leader discovery, version\n * reporting, and failover depend on the coordinator network surface and are\n * deferred (marked 🟡 V0-target in the spec).\n */\n\nimport { NotImplementedError } from \"../core/errors.js\";\nimport type { Session } from \"../core/session.js\";\nimport type { CoordinatorEndpoint } from \"../schemas/types.generated.js\";\nimport { getSessionState } from \"../session/state.js\";\n\n/** Coordinator-reported version and role snapshot. */\nexport interface CoordinatorVersion {\n  readonly mode: \"prod\" | \"dev\";\n  readonly protocolVersion: string;\n  readonly schemaVersion: string;\n  readonly hostname: string;\n  readonly leaderEpoch: number;\n}\n\nexport const coordinator = {\n  /** All configured endpoints, in the order supplied. Read-only. */\n  endpoints(session: Session): readonly CoordinatorEndpoint[] {\n    return getSessionState(session).pool.endpoints;\n  },\n\n  /**\n   * The endpoint currently accepting mutating commands.\n   *\n   * @throws NotImplementedError - deferred (coordinator-pending).\n   */\n  currentLeader(_session: Session): Promise<CoordinatorEndpoint | null> {\n    return Promise.reject(new NotImplementedError(\"coordinator.currentLeader\"));\n  },\n\n  /**\n   * The coordinator-reported version snapshot.\n   *\n   * @throws NotImplementedError - deferred (coordinator-pending).\n   */\n  version(_session: Session): Promise<CoordinatorVersion> {\n    return Promise.reject(new NotImplementedError(\"coordinator.version\"));\n  },\n\n  /**\n   * Tear down the active session and reconnect through the next healthy\n   * endpoint, forcing a fresh attestation.\n   *\n   * @throws NotImplementedError - deferred (coordinator-pending).\n   */\n  forceFailover(_session: Session): Promise<void> {\n    return Promise.reject(new NotImplementedError(\"coordinator.forceFailover\"));\n  },\n};\n"]}
+{"version":3,"sources":["../src/core/version.ts","../src/core/session.ts","../src/transport/inMemoryTransport.ts","../src/presets/azure-prod-maa.generated.ts","../src/presets/productionRuntimeProfile.ts","../src/presets/production.ts","../src/presets/productionBinaryHash.ts","../src/presets/productionMrtd.ts","../src/session/publicReleasePolicy.ts","../src/session/publicSession.ts","../src/attestation/public.ts","../src/coordinator/public.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The API surface version this build implements. Bumped only on a breaking\n * surface change. See docs/sdk-specification.md section 12.\n */\nexport const apiVersion = \"v0\" as const;\n\n/** Literal type of {@link apiVersion}. */\nexport type ApiVersion = typeof apiVersion;\n","/**\n * The opaque session handle.\n *\n * A `Session` is the single stateful object the functional surface threads\n * through every call: `fn(session, args)`. It owns the transport, the\n * attestation state, and (later) the leader-epoch bookkeeping. Consumers treat\n * it as opaque - they read `session.attested` and pass it back to SDK\n * functions, but never reach inside. The internal state map and constructor\n * live alongside `createSession` (added in a later ticket); this module only\n * fixes the public shape so the rest of the surface can type against it.\n */\n\ndeclare const sessionBrand: unique symbol;\n\n/**\n * Opaque, attested session handle. Obtain one from `createSession`; pass it as\n * the first argument to every actor command. The only field consumers read is\n * {@link Session.attested}.\n */\nexport interface Session {\n  /**\n   * Whether the current Noise session has passed full TDX attestation. Sensitive\n   * commands refuse to run until this is `true`. Re-handshake or failover resets\n   * it to `false` until a fresh attestation completes.\n   */\n  readonly attested: boolean;\n  /** @internal Opacity brand; not constructable by consumers. */\n  readonly [sessionBrand]: true;\n}\n\n/** Convenience predicate mirroring {@link Session.attested}. */\nexport function isAttested(session: Session): boolean {\n  return session.attested;\n}\n","/**\n * In-memory transport.\n *\n * A zero-network channel used by unit tests. It transitions straight to `open`\n * on connect. `send` delivers the raw frame bytes to an optional peer sink: the\n * WebSocket message boundary is the frame boundary, so there is no extra length\n * prefix (matching the production transport). Noise lives above this pure byte\n * channel, never inside it.\n *\n * With no peer wired in, `send` is a silent no-op (legacy stub behaviour for\n * tests that never exchange frames). A paired loopback coordinator supplies a\n * `peer` sink so a real Noise XX handshake can run in-process (see the\n * `testLoopback` fixture).\n */\n\nimport { TransportError } from \"../core/errors.js\";\nimport { createStateController } from \"./stateController.js\";\nimport type { Transport, Unsubscribe } from \"./types.js\";\n\n/** Options for {@link inMemoryTransport}. Test-only paired-loopback wiring. */\nexport interface InMemoryTransportOptions {\n  /**\n   * Sink for frames written via `send()`. A paired in-process coordinator sets\n   * this so the client's raw bytes reach the responder. When omitted, `send`\n   * is a no-op so legacy stub-only tests keep working.\n   */\n  readonly peer?: (frame: Uint8Array) => void;\n}\n\n/** In-memory transport with a hook to feed inbound frames into `onMessage`. */\nexport interface InMemoryTransportHandle extends Transport {\n  /** Deliver a frame to this transport's `onMessage` listeners (peer -> client). */\n  readonly deliver: (frame: Uint8Array) => void;\n}\n\nexport function inMemoryTransport(options: InMemoryTransportOptions = {}): InMemoryTransportHandle {\n  const sc = createStateController(\"idle\");\n  const messageListeners = new Set<(frame: Uint8Array) => void>();\n\n  return {\n    state: () => sc.get(),\n    onStateChange: (listener) => sc.onChange(listener),\n    onMessage(listener): Unsubscribe {\n      messageListeners.add(listener);\n      return () => messageListeners.delete(listener);\n    },\n    deliver(frame: Uint8Array): void {\n      for (const listener of messageListeners) listener(frame);\n    },\n    async connect(signal) {\n      if (signal?.aborted) {\n        throw new TransportError(\"CONNECTION_LOST\", \"connect aborted before it started\");\n      }\n      if (sc.get() === \"open\") return;\n      sc.set(\"connecting\");\n      sc.set(\"open\");\n    },\n    send(frame: Uint8Array): void {\n      if (sc.get() !== \"open\") {\n        throw new TransportError(\"CONNECTION_LOST\", \"cannot send on a non-open transport\");\n      }\n      options.peer?.(frame);\n    },\n    close() {\n      if (sc.get() === \"closed\") return;\n      sc.set(\"closing\");\n      sc.set(\"closed\");\n    },\n  };\n}\n","// Generated by npm run release:trust-policy:generate-sdk. Do not edit.\nexport const AZURE_PROD_MAA_TRUST = {\n  issuer: \"https://sharedweu.weu.attest.azure.net\",\n  jwksUrl: \"https://sharedweu.weu.attest.azure.net/certs\",\n  policyHash: \"9NY0VnTQ-IiBriBplVUpFbczcDaEBUwsiFYAzHu_gco\",\n  trustSetVersion: \"azure-prod-maa-v1\",\n} as const;\n","/** Build-time projection of the approved production runtime profile. */\n\nexport const DEFAULT_AZURE_PROD_RUNTIME_PROFILE = \"prod-devnet-simplified\" as const;\nexport const PROD_HARDENED_RUNTIME_PROFILE = \"prod-hardened\" as const;\nexport const PROD_DEVNET_SIMPLIFIED_RUNTIME_PROFILE = \"prod-devnet-simplified\" as const;\nexport const PROD_DEVNET_SIMPLIFIED_LOCKED_RUNTIME_PROFILE =\n  \"prod-devnet-simplified-locked\" as const;\n\ndeclare const __INVISIBLE_SDK_PRODUCTION_RUNTIME_PROFILE__: string | undefined;\n\nconst configuredRuntimeProfile =\n  typeof __INVISIBLE_SDK_PRODUCTION_RUNTIME_PROFILE__ === \"string\"\n    ? __INVISIBLE_SDK_PRODUCTION_RUNTIME_PROFILE__\n    : \"\";\n\nexport const APPROVED_PRODUCTION_RUNTIME_PROFILE =\n  configuredRuntimeProfile === PROD_HARDENED_RUNTIME_PROFILE ||\n  configuredRuntimeProfile === PROD_DEVNET_SIMPLIFIED_RUNTIME_PROFILE ||\n  configuredRuntimeProfile === PROD_DEVNET_SIMPLIFIED_LOCKED_RUNTIME_PROFILE\n    ? configuredRuntimeProfile\n    : DEFAULT_AZURE_PROD_RUNTIME_PROFILE;\n","import { INTEL_SGX_ROOT_CA_FINGERPRINT_SHA256 } from \"../attestation/verifier.js\";\nimport type { CoordinatorEndpoint, CoordinatorReleasePin } from \"../schemas/types.generated.js\";\nimport { AZURE_PROD_MAA_TRUST } from \"./azure-prod-maa.generated.js\";\nimport { APPROVED_PRODUCTION_RUNTIME_PROFILE } from \"./productionRuntimeProfile.js\";\n\nexport const LOCAL_DEV_RELEASE_PIN_MRTD = \"local-dev-no-mrtd\";\n\nexport const PLACEHOLDER_RELEASE_PIN = {\n  mrtd: \"\",\n  intelRootFingerprint: \"\",\n} as const satisfies CoordinatorReleasePin;\n\nexport const AZURE_PROD_COORDINATOR_MRTD =\n  \"a2e61f1316e9e367e9c1f7a0adc98c48eb13875c399c85d286cee5ea2b05e57f2df9f61d903b0ae7ac5607d843dfffc1\";\nexport const AZURE_PROD_RUNTIME_PROFILE = APPROVED_PRODUCTION_RUNTIME_PROFILE;\n\nconst BINARY_HASH_HEX = /^[0-9a-f]{64}$/i;\nconst MRTD_HEX = /^[0-9a-f]{96}$/i;\n\nconst AZURE_PROD_RELEASE_PIN = {\n  mrtd: AZURE_PROD_COORDINATOR_MRTD,\n  runtimeProfile: AZURE_PROD_RUNTIME_PROFILE,\n  intelRootFingerprint: INTEL_SGX_ROOT_CA_FINGERPRINT_SHA256,\n  azureMaa: {\n    issuer: AZURE_PROD_MAA_TRUST.issuer,\n    jwksUrl: AZURE_PROD_MAA_TRUST.jwksUrl,\n    policyHash: AZURE_PROD_MAA_TRUST.policyHash,\n  },\n} as const;\n\nexport function assertApprovedBinaryHash(value: string): string {\n  const binaryHash = typeof value === \"string\" ? value.toLowerCase() : \"\";\n  if (!BINARY_HASH_HEX.test(binaryHash)) {\n    throw new Error(\"an approved 64-character binary SHA-256 hash is required\");\n  }\n  return binaryHash;\n}\n\nexport function assertApprovedMrtd(value: string): string {\n  const mrtd = typeof value === \"string\" ? value.toLowerCase() : \"\";\n  if (!MRTD_HEX.test(mrtd)) {\n    throw new Error(\"an approved 96-character production MRTD is required\");\n  }\n  return mrtd;\n}\n\n/** Build the active Azure production policy for a concrete coordinator URL. */\nexport function createAzureProductionEndpoint({\n  wsUrl,\n  expectedHostname,\n  approvedBinaryHash,\n  approvedMrtd = AZURE_PROD_COORDINATOR_MRTD,\n}: {\n  readonly wsUrl: string;\n  readonly expectedHostname: string;\n  readonly approvedBinaryHash: string;\n  readonly approvedMrtd?: string;\n}): CoordinatorEndpoint {\n  const binaryHash = assertApprovedBinaryHash(approvedBinaryHash);\n  const mrtd = assertApprovedMrtd(approvedMrtd);\n  return {\n    wsUrl,\n    expectedHostname,\n    releasePin: { ...AZURE_PROD_RELEASE_PIN, mrtd, binaryHash },\n    requiredMode: \"prod\",\n  };\n}\n\n/** Build the explicit private dev/test policy. */\nexport function createDevelopmentEndpoint({\n  wsUrl,\n  expectedHostname,\n  allowMissingDcapCollateral,\n}: {\n  readonly wsUrl: string;\n  readonly expectedHostname: string;\n  readonly allowMissingDcapCollateral?: boolean;\n}): CoordinatorEndpoint {\n  return {\n    wsUrl,\n    expectedHostname,\n    releasePin: {\n      ...PLACEHOLDER_RELEASE_PIN,\n      ...(allowMissingDcapCollateral === true ? { allowMissingDcapCollateral: true } : {}),\n    },\n    requiredMode: \"dev\",\n  };\n}\n","/** Build-time projection of the approved coordinator binary hash. */\n\ndeclare const __INVISIBLE_SDK_PRODUCTION_BINARY_HASH__: string | undefined;\n\nexport const APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH =\n  typeof __INVISIBLE_SDK_PRODUCTION_BINARY_HASH__ === \"string\"\n    ? __INVISIBLE_SDK_PRODUCTION_BINARY_HASH__.toLowerCase()\n    : \"\";\n","/** Build-time projection of the approved production coordinator MRTD. */\n\ndeclare const __INVISIBLE_SDK_PRODUCTION_MRTD__: string | undefined;\n\nexport const APPROVED_PRODUCTION_COORDINATOR_MRTD =\n  typeof __INVISIBLE_SDK_PRODUCTION_MRTD__ === \"string\"\n    ? __INVISIBLE_SDK_PRODUCTION_MRTD__.toLowerCase()\n    : \"\";\n","import { APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH } from \"../presets/productionBinaryHash.js\";\nimport { APPROVED_PRODUCTION_COORDINATOR_MRTD } from \"../presets/productionMrtd.js\";\nimport { APPROVED_PRODUCTION_RUNTIME_PROFILE } from \"../presets/productionRuntimeProfile.js\";\nimport type { CoordinatorRuntimeProfile } from \"../attestation/verifier.js\";\n\nexport interface PublicProductionReleasePolicy {\n  readonly expectedMrtd: string;\n  readonly expectedBinaryHash: string;\n  readonly expectedRuntimeProfile: CoordinatorRuntimeProfile;\n}\n\n/** The build-bound production tuple used by the public session constructor. */\nexport function publicProductionReleasePolicy(): PublicProductionReleasePolicy {\n  return {\n    expectedMrtd: APPROVED_PRODUCTION_COORDINATOR_MRTD,\n    expectedBinaryHash: APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH,\n    expectedRuntimeProfile: APPROVED_PRODUCTION_RUNTIME_PROFILE,\n  };\n}\n","import type { Session } from \"../core/session.js\";\nimport { createAzureProductionEndpoint } from \"../presets/production.js\";\nimport { isLoopbackUrl } from \"./secureChannel.js\";\nimport { publicProductionReleasePolicy } from \"./publicReleasePolicy.js\";\nimport {\n  closeSession,\n  createSessionInternal,\n  type CreateSessionOptions as InternalCreateSessionOptions,\n} from \"./createSession.js\";\n\nconst PUBLIC_SESSION_OPTION_KEYS = new Set([\n  \"coordinatorUrl\",\n  \"storage\",\n  \"wallet\",\n  \"clientPersistence\",\n]);\nconst PUBLIC_COORDINATOR_URL_PROTOCOL = \"wss:\";\nconst PUBLIC_COORDINATOR_URL_ERROR =\n  \"public SDK createSession requires a non-loopback wss:// coordinatorUrl\";\n\nexport interface PublicCreateSessionOptions {\n  readonly coordinatorUrl: string;\n  readonly storage?: unknown;\n  readonly wallet?: unknown;\n  /** Opt into SDK-owned normal-user transfer persistence. */\n  readonly clientPersistence?: boolean;\n}\n\n/**\n * Open a production-only public SDK session.\n *\n * The caller supplies only the route and public adapters. The Azure\n * production release policy is embedded by the selected SDK build.\n */\nexport async function createSession(options: PublicCreateSessionOptions): Promise<Session> {\n  assertPublicOptions(options);\n  const parsedUrl = parsePublicCoordinatorUrl(options.coordinatorUrl);\n  const releasePolicy = publicProductionReleasePolicy();\n  const endpoint = createAzureProductionEndpoint({\n    wsUrl: options.coordinatorUrl,\n    expectedHostname: parsedUrl.hostname,\n    approvedBinaryHash: releasePolicy.expectedBinaryHash,\n    approvedMrtd: releasePolicy.expectedMrtd,\n  });\n\n  const internalOptions: InternalCreateSessionOptions = {\n    coordinator: { endpoints: [endpoint] },\n    ...(options.storage === undefined ? {} : { storage: options.storage }),\n    ...(options.wallet === undefined ? {} : { wallet: options.wallet }),\n    ...(options.clientPersistence === undefined\n      ? {}\n      : { clientPersistence: options.clientPersistence }),\n  };\n  return createSessionInternal(internalOptions);\n}\n\nexport { closeSession };\n\nfunction assertPublicOptions(options: unknown): asserts options is PublicCreateSessionOptions {\n  if (typeof options !== \"object\" || options === null || Array.isArray(options)) {\n    throw new TypeError(\"public SDK createSession options must be an object\");\n  }\n  for (const key of Object.keys(options)) {\n    if (!PUBLIC_SESSION_OPTION_KEYS.has(key)) {\n      throw new Error(`public SDK createSession does not accept option ${key}`);\n    }\n  }\n  const coordinatorUrl = (options as { coordinatorUrl?: unknown }).coordinatorUrl;\n  if (typeof coordinatorUrl !== \"string\") {\n    throw new TypeError(\"public SDK createSession requires coordinatorUrl\");\n  }\n  const clientPersistence = (options as { clientPersistence?: unknown }).clientPersistence;\n  if (clientPersistence !== undefined && typeof clientPersistence !== \"boolean\") {\n    throw new TypeError(\"public SDK createSession clientPersistence must be a boolean\");\n  }\n}\n\nfunction parsePublicCoordinatorUrl(value: string): URL {\n  let parsed: URL;\n  try {\n    parsed = new URL(value);\n  } catch (cause) {\n    const error = new Error(PUBLIC_COORDINATOR_URL_ERROR);\n    (error as { cause?: unknown }).cause = cause;\n    throw error;\n  }\n  if (parsed.protocol !== PUBLIC_COORDINATOR_URL_PROTOCOL || isLoopbackUrl(value)) {\n    throw new Error(PUBLIC_COORDINATOR_URL_ERROR);\n  }\n  return parsed;\n}\n","import type { Session } from \"../core/session.js\";\nimport type { AttestationResult } from \"../transport/handshake.js\";\nimport type { Unsubscribe } from \"../transport/types.js\";\nimport { reattestSerialized } from \"./reattest.js\";\nimport { failSessionClosed, getSessionState } from \"../session/state.js\";\nimport {\n  publicProductionReleasePolicy,\n  type PublicProductionReleasePolicy,\n} from \"../session/publicReleasePolicy.js\";\n\nexport type { AttestationResult } from \"../transport/handshake.js\";\n\nexport interface PublicAttestationPolicy {\n  readonly expectedMrtd: string;\n  readonly expectedBinaryHash?: string;\n  readonly expectedRuntimeProfile?:\n    | \"prod-hardened\"\n    | \"prod-devnet-simplified\"\n    | \"prod-devnet-simplified-locked\"\n    | \"azure-tdx-v0-agentless\";\n  readonly expectedRuntimeMeasurements?: {\n    readonly rtmr0: string;\n    readonly rtmr1: string;\n    readonly rtmr2: string;\n    readonly rtmr3: string;\n  };\n  readonly intelRootFingerprint?: string;\n  readonly azureMaa?: {\n    readonly expectedIssuer: string;\n    readonly expectedJwksUrl: string;\n    readonly expectedPolicyHash: string;\n  };\n}\n\n/** Public attestation read controls. Policy construction remains internal. */\nexport const attestation = {\n  productionPolicy(): PublicProductionReleasePolicy {\n    return publicProductionReleasePolicy();\n  },\n\n  async assertValid(session: Session): Promise<AttestationResult> {\n    const state = getSessionState(session);\n    const endpoint = state.pool.endpoints[0]!;\n    try {\n      const result = await reattestSerialized(state, endpoint, state.pool.noiseTransportTimeoutMs);\n      state.attestation = result;\n      state.attested = true;\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      failSessionClosed(state, error);\n      throw error;\n    }\n  },\n\n  current(session: Session): AttestationResult | null {\n    return getSessionState(session).attestation;\n  },\n\n  policy(session: Session): PublicAttestationPolicy {\n    const pin = getSessionState(session).pool.endpoints[0]!.releasePin;\n    return {\n      expectedMrtd: pin.mrtd,\n      ...(pin.binaryHash === undefined ? {} : { expectedBinaryHash: pin.binaryHash }),\n      ...(pin.runtimeProfile === undefined ? {} : { expectedRuntimeProfile: pin.runtimeProfile }),\n      ...(pin.runtimeMeasurements === undefined\n        ? {}\n        : { expectedRuntimeMeasurements: pin.runtimeMeasurements }),\n      ...(pin.intelRootFingerprint === undefined\n        ? {}\n        : { intelRootFingerprint: pin.intelRootFingerprint }),\n      ...(pin.azureMaa === undefined\n        ? {}\n        : {\n            azureMaa: {\n              expectedIssuer: pin.azureMaa.issuer,\n              expectedJwksUrl: pin.azureMaa.jwksUrl,\n              expectedPolicyHash: pin.azureMaa.policyHash,\n            },\n          }),\n    };\n  },\n\n  onPolicyViolation(session: Session, handler: (error: Error) => void): Unsubscribe {\n    const handlers = getSessionState(session).policyViolationHandlers;\n    handlers.add(handler);\n    return () => handlers.delete(handler);\n  },\n};\n","import { NotImplementedError } from \"../core/errors.js\";\nimport type { Session } from \"../core/session.js\";\nimport { getSessionState } from \"../session/state.js\";\n\nexport interface PublicCoordinatorEndpoint {\n  readonly coordinatorUrl: string;\n  readonly roleHint?: \"leader\" | \"watcher\";\n  readonly weight?: number;\n}\n\nexport interface CoordinatorVersion {\n  readonly mode: \"prod\" | \"dev\";\n  readonly protocolVersion: string;\n  readonly schemaVersion: string;\n  readonly hostname: string;\n  readonly leaderEpoch: number;\n}\n\nexport const coordinator = {\n  endpoints(session: Session): readonly PublicCoordinatorEndpoint[] {\n    return getSessionState(session).pool.endpoints.map((endpoint) => ({\n      coordinatorUrl: endpoint.wsUrl,\n      ...(endpoint.roleHint === undefined ? {} : { roleHint: endpoint.roleHint }),\n      ...(endpoint.weight === undefined ? {} : { weight: endpoint.weight }),\n    }));\n  },\n\n  currentLeader(_session: Session): Promise<PublicCoordinatorEndpoint | null> {\n    return Promise.reject(new NotImplementedError(\"coordinator.currentLeader\"));\n  },\n\n  version(_session: Session): Promise<CoordinatorVersion> {\n    return Promise.reject(new NotImplementedError(\"coordinator.version\"));\n  },\n\n  forceFailover(_session: Session): Promise<void> {\n    return Promise.reject(new NotImplementedError(\"coordinator.forceFailover\"));\n  },\n};\n"]}

package/dist/lp.d.ts

@@ -19,6 +19,7 @@ declare function bytesToHex(bytes: Uint8Array): string;
 declare function signLpCommandBytes(auth: LpPositionCodeAuth, bytes: Uint8Array): Promise<Uint8Array>;
 
 type SourceLiquidityUse = "not_materialized" | "available" | "locked_for_payout" | "pending_finality" | "spent" | "released";
+type LpWithdrawalMode = "exact" | "max_available";
 type LpInventoryShard = {
     kind: "lp";
     lpPositionId: string;
@@ -44,8 +45,14 @@ type LpPositionView = {
     refillThreshold: number;
     shards: LpInventoryShard[];
     createdAt: number;
+    redemptionPermission?: LpRedemptionPermission;
     actorSync?: LpActorSyncView;
 };
+type LpRedemptionPermission = {
+    state: "unknown" | "locked" | "enabled";
+    grantRevision: number;
+    observedAtMs: number;
+};
 type LpActorSyncView = {
     lpPositionId: string;
     status: "idle" | "settling" | "reimbursement_due";
@@ -56,6 +63,8 @@ type LpActorSyncView = {
     lifetimeEarnedLamports: number;
     redeemablePrincipalSourceCount: number;
     redeemableFeeSourceCount: number;
+    /** Distinct physical sources contributing to the full redeemable claim. */
+    redeemableSourceCount?: number;
     pendingReservationCount: number;
     reservedPayoutLamports: number;
     estimatedNetworkFeeLamports: number;
@@ -78,6 +87,7 @@ type LpActorSyncView = {
 type LpRedemptionHistoryView = {
     redemptionId: string;
     state: "requested" | "match_requested" | "reserved" | "pending" | "confirmed" | "rejected";
+    withdrawalMode?: LpWithdrawalMode;
     acceptedLamports: number;
     acceptedDepositPrincipalLamports: number;
     acceptedEarnedFeeLamports: number;
@@ -99,8 +109,23 @@ type LpRedemptionHistoryView = {
     createdAtMs: number;
     updatedAtMs: number;
 };
+/** Wallet adapter used only for the coordinator-issued V0 LP admission proof. */
+type LpCreationSigner = {
+    readonly publicKey: string;
+    readonly signMessage: (message: Uint8Array) => Promise<Uint8Array>;
+};
+type LpPositionCreationIntent = {
+    readonly committedLamports: number;
+    readonly shardCount: number;
+    readonly shardAmountLamports: number;
+    readonly refillThreshold: number;
+};
+type LpCreationAuthorization = {
+    readonly authorizationId: string;
+};
 type OpenLpPositionInput = {
     lpPositionId: string;
+    creationAuthorizationId: string;
     authPublicKey: number[];
     refillPublicKey: number[];
     withdrawalCommitment: number[];
@@ -140,6 +165,9 @@ type FinalizeLpDkgBatchInput = {
 type LpWithdrawalExecutionView = {
     withdrawalId: string;
     txSignatures: string[];
+    acceptedLamports: number;
+    acceptedDepositPrincipalLamports: number;
+    acceptedEarnedFeeLamports: number;
 };
 type LpDkgClient = {
     initDkg(input: {
@@ -170,8 +198,9 @@ type LpDkgClient = {
     }>;
 };
 type LpCoordinatorClient = LpDkgClient & {
+    authorizePositionCreation(intent: LpPositionCreationIntent, signer: LpCreationSigner): Promise<LpCreationAuthorization>;
     openPosition(input: OpenLpPositionInput, auth: LpPositionCodeAuth): Promise<LpPositionView>;
-    getPosition(lpPositionId: string, auth: LpPositionCodeAuth): Promise<LpPositionView>;
+    getPosition(lpPositionId: string, auth: LpPositionCodeAuth, options?: LpPositionRequestOptions): Promise<LpPositionView>;
     finalizeDkgBatch(input: FinalizeLpDkgBatchInput, auth: LpPositionCodeAuth): Promise<LpPositionView>;
     refillPosition(input: RefillLpPositionInput, auth: LpPositionCodeAuth): Promise<LpPositionView>;
     reconcileFunding(lpPositionId: string, auth: LpPositionCodeAuth): Promise<LpPositionView>;
@@ -195,13 +224,20 @@ type LpCoordinatorClient = LpDkgClient & {
         destinationAddresses: string[];
         depositPrincipalLamports: number;
         earnedFeeLamports: number;
+        withdrawalMode: LpWithdrawalMode;
         requestedAtMs: number;
         allowManyToOne?: boolean;
     }, auth: LpPositionCodeAuth): Promise<LpWithdrawalExecutionView>;
 };
+interface LpPositionRequestOptions {
+    readonly deadlineMs?: number;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
 
 declare const LP_REDEMPTION_RECONCILING_MESSAGE = "LP redemption is still settling on the coordinator; it will reconcile from sync";
 declare const LP_MISSING_POSITION_CODE_MESSAGE = "Save or recover the LP Position Code before using LP funds";
+declare const LP_FEE_SOURCE_COUNT_UNAVAILABLE_MESSAGE = "LP earned-fee source count is not available; pass allowManyToOne: true to acknowledge many-to-one withdrawal risk";
 type LpLifecycleDkgProgress = {
     readonly phase: "dkg";
     readonly lpPositionId: string;
@@ -211,14 +247,12 @@ type LpLifecycleDkgProgress = {
     readonly total: number;
 };
 interface CreatePositionArgs {
+    readonly wallet: LpCreationSigner;
     readonly committedLamports?: number;
     readonly shardCount?: number;
     readonly refillThreshold?: number;
     readonly feePolicy?: unknown;
-    /**
-     * Called after SDK-owned code generation and before the coordinator open call.
-     * Use this to show/save the code if coordinator intake fails.
-     */
+    /** Called only after the coordinator has durably opened the position. */
     readonly onPositionCode?: (code: LpGeneratedPositionCode) => void;
 }
 interface LpGeneratedPositionCode {
@@ -251,9 +285,11 @@ interface LpTopUpRequest {
     readonly status: "watching" | "funded" | "expired";
 }
 interface WithdrawPositionArgs {
-    /** Accepted LP deposit-principal bucket claim. Computed from the position when omitted. */
+    /** Signed intent mode. The coordinator resolves max_available from sealed state. */
+    readonly withdrawalMode: LpWithdrawalMode;
+    /** Exact LP deposit-principal bucket claim. Required for exact mode. */
     readonly depositPrincipalLamports?: number;
-    /** Accepted earned-fee bucket claim. Computed from the position when omitted. */
+    /** Exact earned-fee bucket claim. Required for exact mode. */
     readonly earnedFeeLamports?: number;
     readonly destinationAddresses: string[];
     /** Required to accept a privacy-degrading single-destination withdrawal. */
@@ -268,6 +304,9 @@ interface RefillArgs {
 interface WithdrawalExecution {
     readonly withdrawalId: string;
     readonly txSignatures: string[];
+    readonly acceptedLamports?: number;
+    readonly acceptedDepositPrincipalLamports?: number;
+    readonly acceptedEarnedFeeLamports?: number;
 }
 interface LpWithdrawalRecord {
     readonly redemptionId: string;
@@ -300,6 +339,7 @@ interface WithdrawalConfirmation {
 }
 interface LpLifecycleRuntime {
     readonly coordinatorClient?: LpCoordinatorClient;
+    readonly reconnectSession?: () => Promise<Session>;
     readonly workerFactory?: () => Worker;
     readonly useDeterministicTestAddresses?: boolean;
     readonly nowMs?: () => number;
@@ -313,19 +353,36 @@ interface WaitForWithdrawalConfirmationOptions {
     readonly onPosition?: (position: LpPositionView) => void;
     readonly onRedemptionUpdate?: (record: LpWithdrawalRecord) => void;
     readonly redemptionRecord?: LpWithdrawalRecord;
+    /** Caller-owned absolute deadline preserved across client/session retries. */
+    readonly deadlineMs?: number;
+    readonly signal?: AbortSignal;
+}
+interface RecoverPositionArgs {
+    readonly code: string;
+    readonly deadlineMs?: number;
+    readonly signal?: AbortSignal;
 }
 interface WaitForTopUpOptions {
     readonly signal?: AbortSignal;
     readonly pollIntervalMs?: number;
     readonly positionId?: string;
 }
+interface LpWithdrawalPlanPreviewArgs {
+    readonly depositPrincipalLamports?: number;
+    readonly earnedFeeLamports?: number;
+    readonly allowManyToOne?: boolean;
+}
+interface LpWithdrawalPlanPreview {
+    readonly depositPrincipalLamports: number;
+    readonly earnedFeeLamports: number;
+    readonly sourceCount: number;
+}
 declare function isLpRedemptionReconcilingError(error: unknown): boolean;
 declare function isLpPositionAuthMissingError(error: unknown): boolean;
+declare function previewLpWithdrawalPlan(position: LpPositionView, args?: LpWithdrawalPlanPreviewArgs): LpWithdrawalPlanPreview;
 interface LpLifecycleClient {
-    createPosition(args?: CreatePositionArgs): Promise<CreatePositionResult>;
-    recoverPosition(args: {
-        readonly code: string;
-    }): Promise<LpPositionView>;
+    createPosition(args: CreatePositionArgs): Promise<CreatePositionResult>;
+    recoverPosition(args: RecoverPositionArgs): Promise<LpPositionView>;
     confirmPositionCodeSaved(positionId: string): void;
     completeDkgBatch(positionId: string, options?: CompleteDkgBatchOptions): Promise<LpPositionView>;
     refreshPosition(positionId: string): Promise<LpPositionView>;
@@ -344,9 +401,12 @@ interface LpLifecycleClient {
 declare function createLpLifecycleClient(session: Session, runtime?: LpLifecycleRuntime): LpLifecycleClient;
 declare function defaultLpLifecycleClient(session: Session): LpLifecycleClient;
 
-declare const LP_COMMAND_REQUEST_TIMEOUT_MS = 120000;
+declare const LP_COMMAND_REQUEST_TIMEOUT_MS = 30000;
 declare const LP_DKG_ABORT_REQUEST_TIMEOUT_MS = 10000;
-declare function createLpCoordinatorClient(session: Session): LpCoordinatorClient;
+type LpCoordinatorClientOptions = {
+    readonly reconnectSession?: () => Promise<Session>;
+};
+declare function createLpCoordinatorClient(session: Session, options?: LpCoordinatorClientOptions): LpCoordinatorClient;
 
 type LpDkgProgress = {
     completed: number;
@@ -369,10 +429,8 @@ declare const LP_DKG_WORKER_REQUEST_TIMEOUT_MESSAGE = "LP DKG worker request tim
 declare const LP_DKG_ABORT_CLEANUP_TIMEOUT_MS = 10000;
 declare function createLpDkgBatch(input: CreateLpDkgBatchInput): Promise<string[]>;
 
-declare function createPosition(session: Session, args?: CreatePositionArgs): Promise<CreatePositionResult>;
-declare function recoverPosition(session: Session, args: {
-    readonly code: string;
-}): Promise<LpPositionView>;
+declare function createPosition(session: Session, args: CreatePositionArgs): Promise<CreatePositionResult>;
+declare function recoverPosition(session: Session, args: RecoverPositionArgs): Promise<LpPositionView>;
 declare function confirmPositionCodeSaved(session: Session, positionId: string): void;
 declare function completeDkgBatch(session: Session, positionId: string, opts?: CompleteDkgBatchOptions): Promise<LpPositionView>;
 declare function refreshPosition(session: Session, positionId: string): Promise<LpPositionView>;
@@ -392,4 +450,4 @@ declare function withdrawFees(session: Session, positionId: string, args: {
 }): Promise<never>;
 declare function listPositions(session: Session): Promise<LpPositionView[]>;
 
-export { type CompleteDkgBatchOptions, type CreateLpDkgBatchInput, type CreatePositionArgs, type CreatePositionResult, type FinalizeLpDkgBatchInput, type FundingConfirmationInput, type InitialFundingPlan, LP_COMMAND_REQUEST_TIMEOUT_MS, LP_DKG_ABORT_CLEANUP_TIMEOUT_MS, LP_DKG_ABORT_REQUEST_TIMEOUT_MS, LP_DKG_WORKER_REQUEST_TIMEOUT_MESSAGE, LP_DKG_WORKER_REQUEST_TIMEOUT_MS, LP_MISSING_POSITION_CODE_MESSAGE, LP_REDEMPTION_RECONCILING_MESSAGE, type LpActorSyncView, type LpCoordinatorClient, type LpDkgClient, type LpDkgProgress, type LpInventoryShard, type LpLifecycleClient, type LpLifecycleDkgProgress, type LpLifecycleRuntime, type LpPositionCode, type LpPositionCodeAuth, type LpPositionView, type LpRedemptionHistoryView, type LpTopUpRequest, type LpWithdrawalExecutionView, type LpWithdrawalRecord, type OpenLpPositionInput, type RefillArgs, type RefillLpPositionInput, type SourceLiquidityUse, type WaitForTopUpOptions, type WaitForWithdrawalConfirmationOptions, type WithdrawPositionArgs, type WithdrawPositionResult, type WithdrawalConfirmation, type WithdrawalExecution, bytesToHex, completeDkgBatch, confirmPositionCodeSaved, createLpCoordinatorClient, createLpDkgBatch, createLpLifecycleClient, createPosition, defaultLpLifecycleClient, deriveLpPositionCodeAuth, generateLpPositionCode, isLpPositionAuthMissingError, isLpRedemptionReconcilingError, listPositions, normalizeLpPositionCode, prepareInitialFunding, prepareTopUp, reconcileFunding, recoverPosition, refill, refreshPosition, signLpCommandBytes, waitForTopUp, waitForWithdrawalConfirmation, withdrawFees, withdrawPosition };
+export { type CompleteDkgBatchOptions, type CreateLpDkgBatchInput, type CreatePositionArgs, type CreatePositionResult, type FinalizeLpDkgBatchInput, type FundingConfirmationInput, type InitialFundingPlan, LP_COMMAND_REQUEST_TIMEOUT_MS, LP_DKG_ABORT_CLEANUP_TIMEOUT_MS, LP_DKG_ABORT_REQUEST_TIMEOUT_MS, LP_DKG_WORKER_REQUEST_TIMEOUT_MESSAGE, LP_DKG_WORKER_REQUEST_TIMEOUT_MS, LP_FEE_SOURCE_COUNT_UNAVAILABLE_MESSAGE, LP_MISSING_POSITION_CODE_MESSAGE, LP_REDEMPTION_RECONCILING_MESSAGE, type LpActorSyncView, type LpCoordinatorClient, type LpCoordinatorClientOptions, type LpCreationAuthorization, type LpCreationSigner, type LpDkgClient, type LpDkgProgress, type LpInventoryShard, type LpLifecycleClient, type LpLifecycleDkgProgress, type LpLifecycleRuntime, type LpPositionCode, type LpPositionCodeAuth, type LpPositionCreationIntent, type LpPositionRequestOptions, type LpPositionView, type LpRedemptionHistoryView, type LpRedemptionPermission, type LpTopUpRequest, type LpWithdrawalExecutionView, type LpWithdrawalMode, type LpWithdrawalPlanPreview, type LpWithdrawalPlanPreviewArgs, type LpWithdrawalRecord, type OpenLpPositionInput, type RecoverPositionArgs, type RefillArgs, type RefillLpPositionInput, type SourceLiquidityUse, type WaitForTopUpOptions, type WaitForWithdrawalConfirmationOptions, type WithdrawPositionArgs, type WithdrawPositionResult, type WithdrawalConfirmation, type WithdrawalExecution, bytesToHex, completeDkgBatch, confirmPositionCodeSaved, createLpCoordinatorClient, createLpDkgBatch, createLpLifecycleClient, createPosition, defaultLpLifecycleClient, deriveLpPositionCodeAuth, generateLpPositionCode, isLpPositionAuthMissingError, isLpRedemptionReconcilingError, listPositions, normalizeLpPositionCode, prepareInitialFunding, prepareTopUp, previewLpWithdrawalPlan, reconcileFunding, recoverPosition, refill, refreshPosition, signLpCommandBytes, waitForTopUp, waitForWithdrawalConfirmation, withdrawFees, withdrawPosition };