@invisible-labs/sdk 0.8.0-devnet → 0.9.0-devnet

package/dist/{chunk-QRN46R3F.js → chunk-RWKG7N7I.js}

@@ -1,4 +1,6 @@
 // src/core/errors.ts
+var COORDINATOR_CAPACITY_FULL_ERROR_CODE = "ERR_ADMISSION_CAPACITY_FULL";
+var COORDINATOR_CAPACITY_FULL_USER_MESSAGE = "The transfer service is temporarily at capacity. This transfer was not started. Please try again later.";
 var InvisibleError = class extends Error {
   constructor(message, options) {
     super(message);
@@ -32,6 +34,8 @@ var CommandError = class extends InvisibleError {
     super(message, options);
     this.code = code;
     if (options?.coordinatorCode !== void 0) this.coordinatorCode = options.coordinatorCode;
+    if (options?.coordinatorMessage !== void 0)
+      this.coordinatorMessage = options.coordinatorMessage;
     if (options?.failedReqId !== void 0) this.failedReqId = options.failedReqId;
   }
 };
@@ -91,6 +95,9 @@ function normalizeError(error, fallback = DEFAULT_ERROR_MESSAGE) {
   return DEFAULT_ERROR_MESSAGE;
 }
 function extractMessage(error) {
+  if (error instanceof CommandError && error.coordinatorCode === COORDINATOR_CAPACITY_FULL_ERROR_CODE) {
+    return error.message;
+  }
   if (error instanceof CommandError && error.coordinatorCode !== void 0) {
     return formatCode(error.coordinatorCode, error.message);
   }
@@ -124,6 +131,6 @@ function isReadable(value) {
   return !/^\[object (?:Object|Event|ErrorEvent|PromiseRejectionEvent)\]$/.test(trimmed);
 }
 
-export { AttestationError, CommandError, InvalidDepositAmountError, InvisibleError, LpLifecycleError, NotImplementedError, PolicyValidationError, RoutingError, StorageError, TransportError, WalletError, isInvisibleError, normalizeError };
-//# sourceMappingURL=chunk-QRN46R3F.js.map
-//# sourceMappingURL=chunk-QRN46R3F.js.map
+export { AttestationError, COORDINATOR_CAPACITY_FULL_ERROR_CODE, COORDINATOR_CAPACITY_FULL_USER_MESSAGE, CommandError, InvalidDepositAmountError, InvisibleError, LpLifecycleError, NotImplementedError, PolicyValidationError, RoutingError, StorageError, TransportError, WalletError, isInvisibleError, normalizeError };
+//# sourceMappingURL=chunk-RWKG7N7I.js.map
+//# sourceMappingURL=chunk-RWKG7N7I.js.map

package/dist/chunk-RWKG7N7I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors.ts"],"names":[],"mappings":";AA8DO,IAAM,oCAAA,GAAuC;AAC7C,IAAM,sCAAA,GACX;AA0GK,IAAe,cAAA,GAAf,cAAsC,KAAA,CAAM;AAAA,EAIjD,WAAA,CAAY,SAAiB,OAAA,EAAiC;AAC5D,IAAA,KAAA,CAAM,OAAO,CAAA;AAGb,IAAA,IAAI,OAAA,EAAS,UAAU,MAAA,EAAW;AAChC,MAAC,IAAA,CAA6B,QAAQ,OAAA,CAAQ,KAAA;AAAA,IAChD;AACA,IAAA,IAAA,CAAK,OAAO,GAAA,CAAA,MAAA,CAAW,IAAA;AAGvB,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AACF;AAGO,IAAM,gBAAA,GAAN,cAA+B,cAAA,CAAe;AAAA,EAEnD,WAAA,CAAY,IAAA,EAA4B,OAAA,EAAiB,OAAA,EAAiC;AACxF,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;AAGO,IAAM,cAAA,GAAN,cAA6B,cAAA,CAAe;AAAA,EAEjD,WAAA,CAAY,IAAA,EAA0B,OAAA,EAAiB,OAAA,EAAiC;AACtF,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;AAGO,IAAM,YAAA,GAAN,cAA2B,cAAA,CAAe;AAAA,EAE/C,WAAA,CAAY,IAAA,EAAwB,OAAA,EAAiB,OAAA,EAAiC;AACpF,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;AAGO,IAAM,YAAA,GAAN,cAA2B,cAAA,CAAe;AAAA,EAM/C,WAAA,CAAY,IAAA,EAAwB,OAAA,EAAiB,OAAA,EAA+B;AAClF,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAI,OAAA,EAAS,eAAA,KAAoB,MAAA,EAAW,IAAA,CAAK,kBAAkB,OAAA,CAAQ,eAAA;AAC3E,IAAA,IAAI,SAAS,kBAAA,KAAuB,MAAA;AAClC,MAAA,IAAA,CAAK,qBAAqB,OAAA,CAAQ,kBAAA;AACpC,IAAA,IAAI,OAAA,EAAS,WAAA,KAAgB,MAAA,EAAW,IAAA,CAAK,cAAc,OAAA,CAAQ,WAAA;AAAA,EACrE;AACF;AAGO,IAAM,yBAAA,GAAN,cAAwC,YAAA,CAAa;AAAA,EAI1D,WAAA,CAAY,kBAA0B,gBAAA,EAA0B;AAC9D,IAAA,KAAA;AAAA,MACE,gBAAA;AAAA,MACA,4BAA4B,gBAAA,CAAiB,QAAA,EAAU,CAAA,yBAAA,EAA4B,gBAAA,CAAiB,UAAU,CAAA,SAAA;AAAA,KAChH;AACA,IAAA,IAAA,CAAK,IAAA,GAAO,2BAAA;AACZ,IAAA,IAAA,CAAK,gBAAA,GAAmB,gBAAA;AACxB,IAAA,IAAA,CAAK,gBAAA,GAAmB,gBAAA;AAAA,EAC1B;AACF;AAGO,IAAM,qBAAA,GAAN,cAAoC,cAAA,CAAe;AAAA,EAExD,WAAA,CAAY,IAAA,EAAiC,OAAA,EAAiB,OAAA,EAAiC;AAC7F,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;AAGO,IAAM,YAAA,GAAN,cAA2B,cAAA,CAAe;AAAA,EAM/C,WAAA,CAAY,IAAA,EAAwB,OAAA,EAAiB,OAAA,EAA+B;AAClF,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAI,OAAA,EAAS,MAAA,KAAW,MAAA,EAAW,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACzD,IAAA,IAAI,OAAA,EAAS,KAAA,KAAU,MAAA,EAAW,IAAA,CAAK,QAAQ,OAAA,CAAQ,KAAA;AACvD,IAAA,IAAI,OAAA,EAAS,cAAA,KAAmB,MAAA,EAAW,IAAA,CAAK,iBAAiB,OAAA,CAAQ,cAAA;AAAA,EAC3E;AACF;AAGO,IAAM,WAAA,GAAN,cAA0B,cAAA,CAAe;AAAA,EAE9C,WAAA,CAAY,IAAA,EAAuB,OAAA,EAAiB,OAAA,EAAiC;AACnF,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;AAGO,IAAM,gBAAA,GAAN,cAA+B,cAAA,CAAe;AAAA,EAEnD,WAAA,CAAY,IAAA,EAA4B,OAAA,EAAiB,OAAA,EAAiC;AACxF,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;AAOO,IAAM,mBAAA,GAAN,cAAkC,cAAA,CAAe;AAAA,EAItD,WAAA,CAAY,SAAiB,OAAA,EAAiC;AAC5D,IAAA,KAAA,CAAM,CAAA,EAAG,OAAO,CAAA,qCAAA,CAAA,EAAyC,OAAO,CAAA;AAJlE,IAAA,IAAA,CAAS,IAAA,GAAO,iBAAA;AAKd,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AACF;AAGO,SAAS,iBAAiB,KAAA,EAAyC;AACxE,EAAA,OAAO,KAAA,YAAiB,cAAA;AAC1B;AAMA,IAAM,qBAAA,GAAwB,yCAAA;AAcvB,SAAS,cAAA,CAAe,KAAA,EAAgB,QAAA,GAAmB,qBAAA,EAA+B;AAC/F,EAAA,MAAM,MAAA,GAAS,eAAe,KAAK,CAAA;AACnC,EAAA,IAAI,UAAA,CAAW,MAAM,CAAA,EAAG,OAAO,MAAA;AAC/B,EAAA,IAAI,UAAA,CAAW,QAAQ,CAAA,EAAG,OAAO,SAAS,IAAA,EAAK;AAC/C,EAAA,OAAO,qBAAA;AACT;AAEA,SAAS,eAAe,KAAA,EAA+B;AACrD,EAAA,IACE,KAAA,YAAiB,YAAA,IACjB,KAAA,CAAM,eAAA,KAAoB,oCAAA,EAC1B;AACA,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EACf;AACA,EAAA,IAAI,KAAA,YAAiB,YAAA,IAAgB,KAAA,CAAM,eAAA,KAAoB,MAAA,EAAW;AACxE,IAAA,OAAO,UAAA,CAAW,KAAA,CAAM,eAAA,EAAiB,KAAA,CAAM,OAAO,CAAA;AAAA,EACxD;AACA,EAAA,IAAI,iBAAiB,cAAA,EAAgB,OAAO,WAAW,KAAA,CAAM,IAAA,EAAM,MAAM,OAAO,CAAA;AAChF,EAAA,IAAI,KAAA,YAAiB,KAAA,EAAO,OAAO,KAAA,CAAM,OAAA;AACzC,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,KAAA;AACtC,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,KAAA,KAAU,MAAA,EAAW,OAAO,IAAA;AAElD,EAAA,IAAI,aAAA,CAAc,KAAK,CAAA,EAAG;AACxB,IAAA,IAAI,OAAO,KAAA,CAAM,OAAA,KAAY,YAAY,UAAA,CAAW,KAAA,CAAM,OAAO,CAAA,EAAG;AAClE,MAAA,OAAO,UAAA,CAAW,KAAA,CAAM,IAAA,EAAM,KAAA,CAAM,OAAO,CAAA;AAAA,IAC7C;AACA,IAAA,MAAM,MAAA,GAAS,cAAA,CAAe,KAAA,CAAM,KAAK,CAAA;AACzC,IAAA,IAAI,WAAW,MAAM,CAAA,SAAU,UAAA,CAAW,KAAA,CAAM,MAAM,MAAM,CAAA;AAC5D,IAAA,MAAM,MAAA,GAAS,cAAA,CAAe,KAAA,CAAM,MAAM,CAAA;AAC1C,IAAA,IAAI,WAAW,MAAM,CAAA,SAAU,UAAA,CAAW,KAAA,CAAM,MAAM,MAAM,CAAA;AAAA,EAC9D;AAEA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,cAAc,KAAA,EAAsC;AAC3D,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAEA,SAAS,UAAA,CAAW,MAAe,OAAA,EAAyB;AAC1D,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,IAAA,GAAO,MAAA,KAAW,CAAA,EAAG,OAAO,OAAA,CAAQ,IAAA,EAAK;AAC9E,EAAA,MAAM,OAAA,GAAU,KAAK,IAAA,EAAK;AAC1B,EAAA,OAAO,OAAA,CAAQ,QAAA,CAAS,CAAA,CAAA,EAAI,OAAO,GAAG,CAAA,GAAI,OAAA,CAAQ,IAAA,EAAK,GAAI,CAAA,CAAA,EAAI,OAAO,CAAA,EAAA,EAAK,OAAA,CAAQ,MAAM,CAAA,CAAA;AAC3F;AAEA,SAAS,WAAW,KAAA,EAAuC;AACzD,EAAA,IAAI,KAAA,KAAU,MAAM,OAAO,KAAA;AAC3B,EAAA,MAAM,OAAA,GAAU,MAAM,IAAA,EAAK;AAC3B,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,KAAA;AACjC,EAAA,OAAO,CAAC,gEAAA,CAAiE,IAAA,CAAK,OAAO,CAAA;AACvF","file":"chunk-RWKG7N7I.js","sourcesContent":["/**\n * The closed error taxonomy from docs/sdk-specification.md section 8.3.\n *\n * Every error the SDK throws extends {@link InvisibleError} and carries a\n * `code` drawn from a closed, per-class string-literal union. Consumers can\n * branch on `error instanceof CommandError` and then exhaustively `switch` on\n * `error.code` with compile-time completeness.\n *\n * Error classes are the one deliberate exception to the SDK's \"no classes\"\n * rule: JavaScript errors must extend `Error` to carry a stack and support\n * `instanceof`. This mirrors @solana/kit, whose only class is `SolanaError`.\n * The conformance lint allowlists this file for that reason.\n */\n\n// ---------------------------------------------------------------------------\n// Code unions (closed sets, section 8.3)\n// ---------------------------------------------------------------------------\n\n/** Attestation verification failures. Stop; do not retry without a new pin. */\nexport type AttestationErrorCode =\n  | \"CERT_CHAIN_INVALID\"\n  | \"TCB_REJECTED\"\n  | \"FRESHNESS_NONCE_MISMATCH\"\n  | \"NOISE_BINDING_MISMATCH\"\n  | \"DEBUG_BIT_SET\"\n  | \"MRTD_MISMATCH\"\n  | \"RUNTIME_MEASUREMENTS_MISMATCH\"\n  | \"RUNTIME_PROFILE_MISMATCH\"\n  | \"AZURE_MAA_ISSUER_MISMATCH\"\n  | \"AZURE_MAA_JWKS_INVALID\"\n  | \"AZURE_MAA_POLICY_HASH_MISMATCH\"\n  | \"AZURE_MAA_NOT_COMPLIANT\"\n  | \"AZURE_MAA_DCAP_MISMATCH\"\n  | \"AZURE_HCL_KEYS_MISMATCH\"\n  | \"AZURE_AK_PUB_INVALID\"\n  | \"AZURE_TPM_AK_QUOTE_INVALID\"\n  | \"AZURE_TPM_QUALIFYING_DATA_MISMATCH\"\n  | \"NOT_ATTESTED\";\n\n/** Transport-level failures. Reconnect through the pool and re-attest. */\nexport type TransportErrorCode =\n  | \"WS_HANDSHAKE_FAILED\"\n  | \"NOISE_HANDSHAKE_FAILED\"\n  | \"NOISE_FRAME_TOO_LARGE\"\n  | \"CONNECTION_LOST\";\n\n/** Leader/role routing failures. Failover and re-attest. */\nexport type RoutingErrorCode =\n  | \"WRONG_ROLE\"\n  | \"STALE_LEADER_EPOCH\"\n  | \"POOL_DEGRADED\"\n  | \"VERSION_NOT_SUPPORTED\";\n\n/** Coordinator-side command rejections. Product decides whether to retry. */\nexport type CommandErrorCode =\n  | \"REJECTED_GUARD\"\n  | \"REJECTED_STATE\"\n  | \"REJECTED_EXPIRED\"\n  | \"REJECTED_STALE_JOB\"\n  | \"REJECTED_RESOURCE_CAP\"\n  | \"RETRYABLE_BUSY\";\n\nexport const COORDINATOR_CAPACITY_FULL_ERROR_CODE = \"ERR_ADMISSION_CAPACITY_FULL\" as const;\nexport const COORDINATOR_CAPACITY_FULL_USER_MESSAGE =\n  \"The transfer service is temporarily at capacity. This transfer was not started. Please try again later.\";\n\n/** Coordinator wire error code preserved on command rejections. */\nexport type CoordinatorWireErrorCode =\n  | \"ERR_INVALID_PAYLOAD\"\n  | \"ERR_UNEXPECTED_TYPE\"\n  | \"ERR_UNKNOWN_SWAP\"\n  | \"ERR_POLICY_VIOLATION\"\n  | \"ERR_INVALID_RECOVERY_CODE\"\n  | \"ERR_SWAP_NOT_REFUNDABLE\"\n  | \"ERR_DKG_FAILURE\"\n  | \"ERR_INTERNAL\"\n  | \"ERR_PRESEAL_ADMISSION_BUSY\"\n  | \"ERR_INITIALIZATION_BUSY\"\n  | typeof COORDINATOR_CAPACITY_FULL_ERROR_CODE\n  | \"ERR_INVALID_DEPOSIT\"\n  | \"ERR_SETTLEMENT_FAILED\";\n\n/** Local input-validation failures. Never sent on the wire; fix the input. */\nexport type PolicyValidationErrorCode =\n  | \"INVALID_PAYOUT_PLAN\"\n  | \"INVALID_WITHDRAWAL_PLAN\"\n  | \"INVALID_POSITION_AUTH\"\n  | \"INVALID_REDEMPTION_PLAN\"\n  | \"INVALID_DESTINATION_ADDRESS\"\n  | \"INVALID_AMOUNT\";\n\n/** Storage-adapter failures. */\nexport type StorageErrorCode =\n  | \"STORAGE_NOT_AVAILABLE\"\n  | \"STORAGE_INVALID_ADAPTER\"\n  | \"STORAGE_QUOTA_EXCEEDED\"\n  | \"STORAGE_KEY_MISSING\"\n  | \"STORAGE_DECRYPT_FAILED\";\n\n/** Wallet-adapter failures. Bubble to the integrator UX. */\nexport type WalletErrorCode =\n  | \"WALLET_NOT_CONNECTED\"\n  | \"WALLET_USER_REJECTED\"\n  | \"WALLET_INVALID_SIGNATURE\";\n\n/** LP lifecycle local state that callers can branch on. */\nexport type LpLifecycleErrorCode = \"LP_POSITION_AUTH_MISSING\" | \"LP_REDEMPTION_RECONCILING\";\n\n/** Skeleton-only: a surface that exists but has no implementation yet. */\nexport type NotImplementedErrorCode = \"NOT_IMPLEMENTED\";\n\n/** Every code the SDK can surface, across all classes. */\nexport type InvisibleErrorCode =\n  | AttestationErrorCode\n  | TransportErrorCode\n  | RoutingErrorCode\n  | CommandErrorCode\n  | PolicyValidationErrorCode\n  | StorageErrorCode\n  | WalletErrorCode\n  | LpLifecycleErrorCode\n  | NotImplementedErrorCode;\n\n// ---------------------------------------------------------------------------\n// Error classes\n// ---------------------------------------------------------------------------\n\n/** Options accepted by every {@link InvisibleError}. */\nexport interface InvisibleErrorOptions {\n  /** The underlying error, preserved for debugging. */\n  readonly cause?: unknown;\n}\n\n/** Context attached to a client-persistence storage failure. */\nexport type StorageErrorPhase =\n  | \"session-init\"\n  | \"write\"\n  | \"allocation\"\n  | \"recovery-code\"\n  | \"ready\"\n  | \"sync\"\n  | \"refund\"\n  | \"read\"\n  | \"remove\"\n  | \"purge\";\n\n/** Options accepted by {@link StorageError}. */\nexport interface StorageErrorOptions extends InvisibleErrorOptions {\n  /** The affected normal-user swap, when known. */\n  readonly swapId?: string;\n  /** The client-persistence lifecycle phase that failed. */\n  readonly phase?: StorageErrorPhase;\n  /** True when the coordinator accepted the command before local failure. */\n  readonly remoteAccepted?: boolean;\n}\n\n/** Options accepted by {@link CommandError}. */\nexport interface CommandErrorOptions extends InvisibleErrorOptions {\n  /** Exact coordinator `Error` envelope code, when the rejection came from the wire. */\n  readonly coordinatorCode?: CoordinatorWireErrorCode;\n  /** Exact coordinator `Error` envelope message, when `message` is user-facing copy. */\n  readonly coordinatorMessage?: string;\n  /** Request id rejected by the coordinator, when present in the `Error` envelope. */\n  readonly failedReqId?: number;\n}\n\n/**\n * Base class for every error the SDK throws. Carries a closed `code` and sets\n * `name` to the concrete subclass name so logs and `instanceof` agree.\n */\nexport abstract class InvisibleError extends Error {\n  /** The closed error code for this error's class. */\n  abstract readonly code: InvisibleErrorCode;\n\n  constructor(message: string, options?: InvisibleErrorOptions) {\n    super(message);\n    // Set `cause` directly rather than through the Error constructor option so\n    // the package stays on the ES2020 lib (the option is ES2022).\n    if (options?.cause !== undefined) {\n      (this as { cause?: unknown }).cause = options.cause;\n    }\n    this.name = new.target.name;\n    // Restore the prototype chain across the transpiled `Error` boundary so\n    // `instanceof` works for subclasses.\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Attestation verification failure. */\nexport class AttestationError extends InvisibleError {\n  readonly code: AttestationErrorCode;\n  constructor(code: AttestationErrorCode, message: string, options?: InvisibleErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/** Transport-level failure. */\nexport class TransportError extends InvisibleError {\n  readonly code: TransportErrorCode;\n  constructor(code: TransportErrorCode, message: string, options?: InvisibleErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/** Leader/role routing failure. */\nexport class RoutingError extends InvisibleError {\n  readonly code: RoutingErrorCode;\n  constructor(code: RoutingErrorCode, message: string, options?: InvisibleErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/** Coordinator-side command rejection. */\nexport class CommandError extends InvisibleError {\n  readonly code: CommandErrorCode;\n  readonly coordinatorCode?: CoordinatorWireErrorCode;\n  readonly coordinatorMessage?: string;\n  readonly failedReqId?: number;\n\n  constructor(code: CommandErrorCode, message: string, options?: CommandErrorOptions) {\n    super(message, options);\n    this.code = code;\n    if (options?.coordinatorCode !== undefined) this.coordinatorCode = options.coordinatorCode;\n    if (options?.coordinatorMessage !== undefined)\n      this.coordinatorMessage = options.coordinatorMessage;\n    if (options?.failedReqId !== undefined) this.failedReqId = options.failedReqId;\n  }\n}\n\n/** User deposit did not match the coordinator policy amount. */\nexport class InvalidDepositAmountError extends CommandError {\n  readonly receivedLamports: bigint;\n  readonly expectedLamports: bigint;\n\n  constructor(receivedLamports: bigint, expectedLamports: bigint) {\n    super(\n      \"REJECTED_GUARD\",\n      `on-chain deposit balance ${receivedLamports.toString()} does not match expected ${expectedLamports.toString()} lamports`,\n    );\n    this.name = \"InvalidDepositAmountError\";\n    this.receivedLamports = receivedLamports;\n    this.expectedLamports = expectedLamports;\n  }\n}\n\n/** Local input-validation failure; never reaches the wire. */\nexport class PolicyValidationError extends InvisibleError {\n  readonly code: PolicyValidationErrorCode;\n  constructor(code: PolicyValidationErrorCode, message: string, options?: InvisibleErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/** Storage-adapter failure. */\nexport class StorageError extends InvisibleError {\n  readonly code: StorageErrorCode;\n  readonly swapId?: string;\n  readonly phase?: StorageErrorPhase;\n  readonly remoteAccepted?: boolean;\n\n  constructor(code: StorageErrorCode, message: string, options?: StorageErrorOptions) {\n    super(message, options);\n    this.code = code;\n    if (options?.swapId !== undefined) this.swapId = options.swapId;\n    if (options?.phase !== undefined) this.phase = options.phase;\n    if (options?.remoteAccepted !== undefined) this.remoteAccepted = options.remoteAccepted;\n  }\n}\n\n/** Wallet-adapter failure. */\nexport class WalletError extends InvisibleError {\n  readonly code: WalletErrorCode;\n  constructor(code: WalletErrorCode, message: string, options?: InvisibleErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/** LP lifecycle state that is local to the SDK client. */\nexport class LpLifecycleError extends InvisibleError {\n  readonly code: LpLifecycleErrorCode;\n  constructor(code: LpLifecycleErrorCode, message: string, options?: InvisibleErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/**\n * A surface that exists in the typed contract but has no runtime behavior yet.\n * The skeleton throws this from every command that is not the connection layer.\n * The message carries the fully-qualified command name (e.g. `user.contractRequest`).\n */\nexport class NotImplementedError extends InvisibleError {\n  readonly code = \"NOT_IMPLEMENTED\" as const;\n  /** The command that is not yet implemented, e.g. `lp.redeem`. */\n  readonly command: string;\n  constructor(command: string, options?: InvisibleErrorOptions) {\n    super(`${command} is not implemented in this SDK build`, options);\n    this.command = command;\n  }\n}\n\n/** Type guard: is `value` any SDK error. */\nexport function isInvisibleError(value: unknown): value is InvisibleError {\n  return value instanceof InvisibleError;\n}\n\n// ---------------------------------------------------------------------------\n// Normalization (analog of web/src/lib/user-facing-error.ts)\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_ERROR_MESSAGE = \"Something went wrong. Please try again.\";\n\ninterface MessageLike {\n  readonly message?: unknown;\n  readonly reason?: unknown;\n  readonly error?: unknown;\n  readonly code?: unknown;\n}\n\n/**\n * Reduce any thrown value to a readable, single-line message. Guarantees the\n * SDK never surfaces `[object Object]` / `[object ErrorEvent]` (spec section\n * 8.3). For an {@link InvisibleError} the code is prefixed as `[CODE] message`.\n */\nexport function normalizeError(error: unknown, fallback: string = DEFAULT_ERROR_MESSAGE): string {\n  const direct = extractMessage(error);\n  if (isReadable(direct)) return direct;\n  if (isReadable(fallback)) return fallback.trim();\n  return DEFAULT_ERROR_MESSAGE;\n}\n\nfunction extractMessage(error: unknown): string | null {\n  if (\n    error instanceof CommandError &&\n    error.coordinatorCode === COORDINATOR_CAPACITY_FULL_ERROR_CODE\n  ) {\n    return error.message;\n  }\n  if (error instanceof CommandError && error.coordinatorCode !== undefined) {\n    return formatCode(error.coordinatorCode, error.message);\n  }\n  if (error instanceof InvisibleError) return formatCode(error.code, error.message);\n  if (error instanceof Error) return error.message;\n  if (typeof error === \"string\") return error;\n  if (error === null || error === undefined) return null;\n\n  if (isMessageLike(error)) {\n    if (typeof error.message === \"string\" && isReadable(error.message)) {\n      return formatCode(error.code, error.message);\n    }\n    const nested = extractMessage(error.error);\n    if (isReadable(nested)) return formatCode(error.code, nested);\n    const reason = extractMessage(error.reason);\n    if (isReadable(reason)) return formatCode(error.code, reason);\n  }\n\n  return null;\n}\n\nfunction isMessageLike(value: unknown): value is MessageLike {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction formatCode(code: unknown, message: string): string {\n  if (typeof code !== \"string\" || code.trim().length === 0) return message.trim();\n  const trimmed = code.trim();\n  return message.includes(`[${trimmed}]`) ? message.trim() : `[${trimmed}] ${message.trim()}`;\n}\n\nfunction isReadable(value: string | null): value is string {\n  if (value === null) return false;\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return false;\n  return !/^\\[object (?:Object|Event|ErrorEvent|PromiseRejectionEvent)\\]$/.test(trimmed);\n}\n"]}

package/dist/coordinator-DHL3AP7V.js

@@ -0,0 +1,4 @@
+export { COORDINATOR_BINARY_FIELD_NAMES, COORDINATOR_ENVELOPE_SCHEMA, COORDINATOR_SCHEMA_PAYLOAD_CATEGORIES, CoordinatorError, CoordinatorMessageType, DEFAULT_PAYOUT_WINDOW_ID, DIRECTION_BY_TYPE, ENVELOPE_VERSION, EnvelopeKind, ErrorCode, INITIAL_STATE, MAX_ENCODED_JSON_BYTES_KEYWORD, MAX_FRAME_SIZE, MessageDirection, PAYOUT_WINDOW_OPTIONS, TERMINAL_STATES, TRANSITIONS, VALID_SWAP_STATES, asDelegateAckPayload, asDelegateSharePayload, asDelegateShareResponsePayload, asDepositConfirmedPayload, asDkgCompletePayload, asDkgInitPayload, asDkgInitResponsePayload, asDkgRound1Payload, asDkgRound1ResponsePayload, asDkgRound2Payload, asDkgRound2ResponsePayload, asErrorPayload, asLpCommandResponsePayload, asPayoutExecutedPayload, asSwapRequestPayload, asSwapRequestResponsePayload, asSyncRequiredPayload, asSyncUserRequestPayload, asSyncUserResponsePayload, asWithdrawAcceptedPayload, asWithdrawExecutedPayload, asWithdrawRequestPayload, createCoordinatorSchemaValidator, decode, encode, encodeLpCommandForSigning, encodeValidated, isAllowedInState, isAllowedKindForType, isPayoutWindowId, isValidEnvelopeKind, isValidErrorCode, isValidMessageType, isValidSwapState, lpSignedCommandEnvelope, nextState, payloadCategory, payoutWindowLabelForId, payoutWindowOptionById, safeEncode, scheduledPayoutWindowOptions, scheduledPayoutWindowSeconds } from './chunk-QF5TSUQE.js';
+import './chunk-VR6T6OJS.js';
+//# sourceMappingURL=coordinator-DHL3AP7V.js.map
+//# sourceMappingURL=coordinator-DHL3AP7V.js.map

package/dist/{coordinator-E2TS6NR2.js.map → coordinator-DHL3AP7V.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"coordinator-E2TS6NR2.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"coordinator-DHL3AP7V.js"}

package/dist/dkgWorker.js

@@ -1,4 +1,4 @@
-import { ensureFrostWasm, loadFrost } from './chunk-K67FTCQU.js';
+import { ensureFrostWasm, loadFrost } from './chunk-JNNVPZEU.js';
 import './chunk-VR6T6OJS.js';
 
 // src/lp/dkgWorker.ts

package/dist/events.js

@@ -1,6 +1,6 @@
-import { onEnvelope, EnvelopeKind, CoordinatorMessageType } from './chunk-MZKJU3UA.js';
-import './chunk-HJFMDMPY.js';
-import { NotImplementedError } from './chunk-QRN46R3F.js';
+import { onEnvelope, EnvelopeKind, CoordinatorMessageType } from './chunk-ISIWWGSR.js';
+import './chunk-6AKBRYKO.js';
+import { NotImplementedError } from './chunk-RWKG7N7I.js';
 import './chunk-VR6T6OJS.js';
 
 // src/events/index.ts

package/dist/frostRuntime-JESDHN6O.js

@@ -0,0 +1,4 @@
+export { ensureFrostWasm, loadFrost } from './chunk-JNNVPZEU.js';
+import './chunk-VR6T6OJS.js';
+//# sourceMappingURL=frostRuntime-JESDHN6O.js.map
+//# sourceMappingURL=frostRuntime-JESDHN6O.js.map

package/dist/{frostRuntime-6FTPKUCP.js.map → frostRuntime-JESDHN6O.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"frostRuntime-6FTPKUCP.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"frostRuntime-JESDHN6O.js"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { S as Session } from './session-DFuy54C-.js';
 export { i as isAttested } from './session-DFuy54C-.js';
-export { A as AttestationError, a as AttestationErrorCode, C as CommandError, b as CommandErrorCode, c as CommandErrorOptions, d as CoordinatorWireErrorCode, I as InvalidDepositAmountError, e as InvisibleError, f as InvisibleErrorCode, g as InvisibleErrorOptions, L as LpLifecycleError, h as LpLifecycleErrorCode, i as LpPositionView, N as NotImplementedError, j as NotImplementedErrorCode, k as PayoutDestination, P as PayoutPolicy, l as PolicyValidationError, m as PolicyValidationErrorCode, R as RoutingError, n as RoutingErrorCode, o as RuntimeMeasurements, S as StorageEnvelope, p as StorageError, q as StorageErrorCode, r as StorageErrorOptions, s as StorageErrorPhase, T as TransportError, t as TransportErrorCode, W as WalletError, u as WalletErrorCode, v as isInvisibleError, w as normalizeError } from './types.generated-YhFu9ZBR.js';
+export { A as AttestationError, a as AttestationErrorCode, C as CommandError, b as CommandErrorCode, c as CommandErrorOptions, d as CoordinatorWireErrorCode, I as InvalidDepositAmountError, e as InvisibleError, f as InvisibleErrorCode, g as InvisibleErrorOptions, L as LpLifecycleError, h as LpLifecycleErrorCode, i as LpPositionView, N as NotImplementedError, j as NotImplementedErrorCode, k as PayoutDestination, P as PayoutPolicy, l as PolicyValidationError, m as PolicyValidationErrorCode, R as RoutingError, n as RoutingErrorCode, o as RuntimeMeasurements, S as StorageEnvelope, p as StorageError, q as StorageErrorCode, r as StorageErrorOptions, s as StorageErrorPhase, T as TransportError, t as TransportErrorCode, W as WalletError, u as WalletErrorCode, v as isInvisibleError, w as normalizeError } from './types.generated-DrM2M4DZ.js';
 import { T as Transport, N as NoiseWebSocketTransportOptions, U as Unsubscribe } from './types-ZhV7TIQY.js';
 export { C as ConnectionState, W as WebSocketFactory, a as WebSocketLike } from './types-ZhV7TIQY.js';
 

package/dist/index.js

@@ -1,10 +1,10 @@
-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 { createStateController, createSessionInternal, isLoopbackUrl, reattestSerialized, INTEL_SGX_ROOT_CA_FINGERPRINT_SHA256 } from './chunk-EOPZVOVP.js';
+export { closeSession, createExponentialBackoff, noiseWebSocketTransport } from './chunk-EOPZVOVP.js';
+export { assertAttested, hex, lamports, publicKey, requestId } from './chunk-EPWTRF5U.js';
+import { getSessionState, failSessionClosed } from './chunk-6AKBRYKO.js';
+import './chunk-AIKC2XQS.js';
+import { TransportError, NotImplementedError } from './chunk-RWKG7N7I.js';
+export { AttestationError, CommandError, InvalidDepositAmountError, InvisibleError, LpLifecycleError, NotImplementedError, PolicyValidationError, RoutingError, StorageError, TransportError, WalletError, isInvisibleError, normalizeError } from './chunk-RWKG7N7I.js';
 import './chunk-VR6T6OJS.js';
 
 // src/core/version.ts
@@ -105,7 +105,7 @@ function createAzureProductionEndpoint({
 }
 
 // src/presets/productionBinaryHash.ts
-var APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH = "2eb6efac5b38562b0759043155556034ea105db40094f0e424762f05ae441da8".toLowerCase() ;
+var APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH = "176a3f8eb8941bb6b9dd85a044eff1df686df87ff757133a4df467ba46d7c7cf".toLowerCase() ;
 
 // src/presets/productionMrtd.ts
 var APPROVED_PRODUCTION_COORDINATOR_MRTD = "6f3e84c54ac6377614d4c139473db575a83b5db41bd845eecb4eedaf2788ea881309a410c4ceae9641406411f3f639b8".toLowerCase() ;

package/dist/lp.d.ts

@@ -53,7 +53,15 @@ type LpRedemptionPermission = {
     grantRevision: number;
     observedAtMs: number;
 };
+type LpEconomicReturnSummary = {
+    providerRewardLamports: string;
+    sourceExpenseCompensationLamports: string;
+    chargedReimbursementLossLamports: string;
+    /** Provider reward minus charged losses; nominal source expense compensation is excluded. */
+    netEconomicReturnLamports: string;
+};
 type LpActorSyncView = {
+    economicReturn?: LpEconomicReturnSummary;
     lpPositionId: string;
     status: "idle" | "settling" | "reimbursement_due";
     sourceLiquidityUse: SourceLiquidityUse;
@@ -322,6 +330,7 @@ interface LpWithdrawalRecord {
     readonly landedBaselineLamports: number;
     readonly landedFeeBaselineLamports?: number;
     readonly redeemedLamports: number;
+    readonly networkFeeLossLamports?: number;
     readonly txSignatures: string[];
     readonly txSignatureBaseline: string[];
     readonly coordinatorStateVersion?: number;
@@ -450,4 +459,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_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 };
+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 LpEconomicReturnSummary, 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 };

package/dist/lp.js

@@ -1,8 +1,8 @@
-import { isValidLpPositionId, LP_DEFAULT_REFILL_BATCH_SIZE, LP_DEFAULT_TARGET_SHARDS, LP_MAX_TARGET_SHARDS, LP_MAX_REFILL_BATCH_SIZE } from './chunk-IG6JJFR2.js';
-import { publicKey, assertAttested, lamports } from './chunk-EBWTAXNT.js';
-import { requestEnvelope, CoordinatorMessageType } from './chunk-MZKJU3UA.js';
-import { getSessionState } from './chunk-HJFMDMPY.js';
-import { CommandError, WalletError, TransportError, PolicyValidationError, RoutingError, LpLifecycleError } from './chunk-QRN46R3F.js';
+import { isValidLpPositionId, LP_MAX_TOTAL_SHARDS, LP_MAX_INITIAL_SHARDS, LP_MAX_REFILL_BATCH_SIZE, LP_SHARD_PAGE_SIZE, LP_DEFAULT_REFILL_BATCH_SIZE, LP_DEFAULT_TARGET_SHARDS } from './chunk-HWRMSK7E.js';
+import { publicKey, assertAttested, lamports } from './chunk-EPWTRF5U.js';
+import { requestEnvelope, CoordinatorMessageType } from './chunk-ISIWWGSR.js';
+import { getSessionState } from './chunk-6AKBRYKO.js';
+import { CommandError, WalletError, TransportError, PolicyValidationError, RoutingError, LpLifecycleError } from './chunk-RWKG7N7I.js';
 import './chunk-VR6T6OJS.js';
 
 // src/lp/positionCode.ts
@@ -231,6 +231,11 @@ var COMMAND_TTL_MS = 3e4;
 var LP_POSITION_OPEN_COMMAND_TTL_MS = 55e3;
 var LP_POSITION_OPEN_REQUEST_TIMEOUT_MS = 2e4;
 var LP_COMMAND_REQUEST_TIMEOUT_MS = COMMAND_TTL_MS;
+var LP_POSITION_HYDRATION_TIMEOUT_MS = LP_COMMAND_REQUEST_TIMEOUT_MS;
+var LP_POSITION_SNAPSHOT_MAX_ATTEMPTS = 3;
+var LP_SHARD_SNAPSHOT_CHANGED_MESSAGE = "LP shard snapshot changed";
+var LP_SHARD_PAGE_INVALID_MESSAGE = "coordinator LP shard page is invalid";
+var LP_SHARD_SNAPSHOT_HASH_PATTERN = /^[0-9a-f]{64}$/;
 var LP_CREATION_CHALLENGE_REQUEST_TIMEOUT_MS = 3e4;
 var LP_CREATION_WALLET_SIGNATURE_TIMEOUT_MS = 45e3;
 var LP_CREATION_PROOF_REQUEST_TIMEOUT_MS = 15e3;
@@ -527,7 +532,7 @@ async function openPosition(session, input, auth, reconnectSession) {
       commandOptions
     );
   }
-  return expectPosition(response);
+  return hydratePositionResponse(session, auth.lpPositionId, auth, response);
 }
 async function reconnectSessionWithinDeadline(reconnectSession, deadlineMs) {
   const remainingMs = deadlineMs - Date.now();
@@ -561,37 +566,130 @@ function isAmbiguousCoordinatorRequestFailure(error) {
   return error instanceof TransportError || error instanceof CommandError && error.code === "REJECTED_STALE_JOB";
 }
 async function getPosition(session, lpPositionId, auth, options = {}) {
-  let cursor;
-  let position;
-  const seenCursors = /* @__PURE__ */ new Set();
-  for (; ; ) {
-    const pageOptions = lpPositionPageRequestOptions(options);
-    const response = await requestForPosition(
-      session,
-      lpPositionId,
-      auth,
-      "position_get",
-      {
-        case: "positionGet",
-        value: cursor === void 0 ? {} : { redemption_history_cursor: cursor }
-      },
-      pageOptions
-    );
-    const page = expectPosition(response);
-    const mergedPosition = position === void 0 ? page : mergePositionHistoryPages(position, page);
-    position = mergedPosition;
-    const actorSync = page.actorSync;
-    if (actorSync?.redemptionHistoryHasMore !== true) return mergedPosition;
-    const nextCursor = actorSync.redemptionHistoryNextCursor;
-    if (nextCursor === void 0 || seenCursors.has(nextCursor)) {
-      throw new CommandError(
-        "REJECTED_STATE",
-        "coordinator LP actor sync returned an invalid redemption history cursor"
+  return hydratePositionResponse(session, lpPositionId, auth, void 0, options);
+}
+async function hydratePositionResponse(session, lpPositionId, auth, initialResponse, options = {}) {
+  const boundedOptions = {
+    ...options,
+    deadlineMs: options.deadlineMs ?? Date.now() + LP_POSITION_HYDRATION_TIMEOUT_MS
+  };
+  for (let attempt = 0; attempt < LP_POSITION_SNAPSHOT_MAX_ATTEMPTS; attempt += 1) {
+    try {
+      const response = initialResponse ?? await requestForPosition(
+        session,
+        lpPositionId,
+        auth,
+        "position_get",
+        { case: "positionGet", value: {} },
+        boundedOptions
       );
+      if (response.case !== "position")
+        throw new CommandError("REJECTED_STATE", LP_SHARD_PAGE_INVALID_MESSAGE);
+      const first = response.value;
+      let full = first;
+      if (first.shards_snapshot_hash !== void 0 || first.shards_total_count !== void 0 || first.shards_next_index !== void 0) {
+        assertShardPage(first, first, lpPositionId, auth, 0);
+        const shards = [...first.shards];
+        let nextIndex = first.shards_next_index;
+        while (nextIndex !== void 0) {
+          const nextResponse = await requestForPosition(
+            session,
+            lpPositionId,
+            auth,
+            "position_get",
+            {
+              case: "positionGet",
+              value: {
+                shard_start_index: nextIndex,
+                shards_snapshot_hash: first.shards_snapshot_hash
+              }
+            },
+            boundedOptions
+          );
+          if (nextResponse.case !== "position")
+            throw new CommandError("REJECTED_STATE", LP_SHARD_PAGE_INVALID_MESSAGE);
+          assertShardPage(first, nextResponse.value, lpPositionId, auth, nextIndex);
+          shards.push(...nextResponse.value.shards);
+          nextIndex = nextResponse.value.shards_next_index;
+        }
+        if (shards.length !== first.shards_total_count)
+          throw new CommandError("REJECTED_STATE", LP_SHARD_PAGE_INVALID_MESSAGE);
+        full = { ...first, shards };
+      } else if (first.target_shard_count > LP_MAX_TOTAL_SHARDS || first.lp_position_id !== lpPositionId || first.shards.length > LP_MAX_INITIAL_SHARDS || first.status !== "dkg_pending" && first.target_shard_count > LP_MAX_INITIAL_SHARDS && first.shards.length !== first.target_shard_count || first.status === "dkg_pending" && first.target_shard_count > LP_MAX_INITIAL_SHARDS && first.target_shard_count - first.shards.length > LP_MAX_REFILL_BATCH_SIZE) {
+        throw new CommandError("REJECTED_STATE", LP_SHARD_PAGE_INVALID_MESSAGE);
+      }
+      let position = mapPosition(full);
+      let historyPage = first;
+      const seenCursors = /* @__PURE__ */ new Set();
+      while (historyPage.actor_sync?.redemption_history_has_more === true) {
+        const cursor = historyPage.actor_sync.redemption_history_next_cursor;
+        if (cursor === void 0 || seenCursors.has(cursor)) {
+          throw new CommandError(
+            "REJECTED_STATE",
+            "coordinator LP actor sync returned an invalid redemption history cursor"
+          );
+        }
+        seenCursors.add(cursor);
+        const nextResponse = await requestForPosition(
+          session,
+          lpPositionId,
+          auth,
+          "position_get",
+          {
+            case: "positionGet",
+            value: {
+              redemption_history_cursor: cursor,
+              ...first.shards_snapshot_hash === void 0 ? {} : { shard_start_index: 0, shards_snapshot_hash: first.shards_snapshot_hash }
+            }
+          },
+          boundedOptions
+        );
+        if (nextResponse.case !== "position")
+          throw new CommandError("REJECTED_STATE", LP_SHARD_PAGE_INVALID_MESSAGE);
+        historyPage = nextResponse.value;
+        if (first.shards_snapshot_hash !== void 0)
+          assertShardPage(first, historyPage, lpPositionId, auth, 0);
+        const historyView = mapPosition(historyPage);
+        const merged = mergePositionHistoryPages(position, historyView);
+        position = first.shards_snapshot_hash === void 0 ? merged : {
+          ...position,
+          actorSync: position.actorSync === void 0 ? void 0 : {
+            ...position.actorSync,
+            redemptionHistory: merged.actorSync?.redemptionHistory,
+            redemptionHistoryHasMore: historyView.actorSync?.redemptionHistoryHasMore ?? false,
+            redemptionHistoryNextCursor: historyView.actorSync?.redemptionHistoryNextCursor
+          }
+        };
+      }
+      lpPositionPageRequestOptions(boundedOptions);
+      return position;
+    } catch (error) {
+      if (!(error instanceof CommandError) || !error.message.includes(LP_SHARD_SNAPSHOT_CHANGED_MESSAGE) || attempt + 1 >= LP_POSITION_SNAPSHOT_MAX_ATTEMPTS)
+        throw error;
+      initialResponse = void 0;
+      lpPositionPageRequestOptions(boundedOptions);
     }
-    seenCursors.add(nextCursor);
-    cursor = nextCursor;
   }
+  throw new CommandError("REJECTED_STATE", LP_SHARD_SNAPSHOT_CHANGED_MESSAGE);
+}
+function assertShardPage(first, page, lpPositionId, auth, startIndex) {
+  const total = first.shards_total_count;
+  const invalid = () => {
+    throw new CommandError("REJECTED_STATE", LP_SHARD_PAGE_INVALID_MESSAGE);
+  };
+  if (total === void 0 || !Number.isInteger(total) || total < 1 || total > LP_MAX_TOTAL_SHARDS || total > first.target_shard_count || first.status !== "dkg_pending" && total !== first.target_shard_count || first.shards_snapshot_hash === void 0 || !LP_SHARD_SNAPSHOT_HASH_PATTERN.test(first.shards_snapshot_hash) || page.lp_position_id !== lpPositionId || page.shards_snapshot_hash !== first.shards_snapshot_hash || page.shards_total_count !== total || page.target_shard_count !== first.target_shard_count || page.status !== "dkg_pending" && total !== page.target_shard_count || page.created_at_ms !== first.created_at_ms || page.committed_lamports !== first.committed_lamports || page.earned_lamports !== first.earned_lamports || page.refill_threshold !== first.refill_threshold || bytesToHex(page.auth_public_key) !== bytesToHex(auth.authPublicKey) || bytesToHex(page.refill_public_key) !== bytesToHex(first.refill_public_key) || bytesToHex(page.redemption_commitment) !== bytesToHex(first.redemption_commitment) || page.shards.length !== Math.min(LP_SHARD_PAGE_SIZE, total - startIndex) || page.shards.length === 0)
+    invalid();
+  for (const [offset, shard] of page.shards.entries()) {
+    const index = startIndex + offset;
+    if (shard.index !== index || shard.lp_position_id !== lpPositionId || shard.shard_id !== `${lpPositionId}:shard:${index}`)
+      invalid();
+  }
+  const end = startIndex + page.shards.length;
+  if (total === void 0) invalid();
+  if (end < total ? page.shards_next_index !== end : page.shards_next_index !== void 0)
+    invalid();
+  if (page.status !== first.status)
+    throw new CommandError("REJECTED_STATE", LP_SHARD_SNAPSHOT_CHANGED_MESSAGE);
 }
 function lpPositionPageRequestOptions(options) {
   if (options.deadlineMs === void 0) return options;
@@ -614,7 +712,7 @@ async function finalizeDkgBatch(session, input, auth) {
       finalized_at_ms: input.finalizedAtMs
     }
   });
-  return expectPosition(response);
+  return hydratePositionResponse(session, auth.lpPositionId, auth, response);
 }
 async function refillPosition(session, input, auth) {
   const response = await requestForPosition(session, input.lpPositionId, auth, "refill", {
@@ -626,14 +724,14 @@ async function refillPosition(session, input, auth) {
       authorized_at_ms: input.authorizedAtMs
     }
   });
-  return expectPosition(response);
+  return hydratePositionResponse(session, auth.lpPositionId, auth, response);
 }
 async function reconcileFunding(session, lpPositionId, auth) {
   const response = await requestForPosition(session, lpPositionId, auth, "reconcile_funding", {
     case: "reconcileFunding",
     value: {}
   });
-  return expectPosition(response);
+  return hydratePositionResponse(session, auth.lpPositionId, auth, response);
 }
 async function planFunding(session, input, auth) {
   const response = await requestForPosition(session, input.lpPositionId, auth, "funding_plan", {
@@ -738,7 +836,7 @@ function request(session, auth, action, payload) {
   return requestForPosition(session, auth.lpPositionId, auth, action, payload);
 }
 async function requestForPosition(session, lpPositionId, auth, action, payload, options = {}) {
-  const timeoutMs = options.timeoutMs ?? LP_COMMAND_REQUEST_TIMEOUT_MS;
+  const timeoutMs = lpPositionPageRequestOptions(options).timeoutMs ?? LP_COMMAND_REQUEST_TIMEOUT_MS;
   assertAuthMatchesPosition(lpPositionId, auth);
   const protocol = await loadProtocol();
   const state = getSessionState(session);
@@ -773,10 +871,6 @@ function assertAuthMatchesPosition(lpPositionId, auth) {
     "LP Position Code does not match the target LP position"
   );
 }
-function expectPosition(response) {
-  if (response.case !== "position") throw new Error("Unexpected LP position response");
-  return mapPosition(response.value);
-}
 function mapPosition(position) {
   return {
     id: position.lp_position_id,
@@ -823,6 +917,7 @@ function mapLpActorSync(actorSync) {
   }
   const redeemableProjectionAvailable = redeemableBucketCount === redeemableBucketValues.length;
   return {
+    ...actorSync.economic_return === void 0 ? {} : { economicReturn: mapLpEconomicReturn(actorSync.economic_return) },
     lpPositionId: actorSync.lp_position_id,
     status: actorSync.status,
     sourceLiquidityUse: actorSync.source_liquidity_use,
@@ -853,6 +948,33 @@ function mapLpActorSync(actorSync) {
     updatedAtMs: actorSync.updated_at_ms
   };
 }
+var LP_ECONOMIC_UNSIGNED_TOTAL_MAX = (1n << 128n) - 1n;
+var LP_ECONOMIC_SIGNED_TOTAL_MIN = -(1n << 127n);
+var LP_ECONOMIC_SIGNED_TOTAL_MAX = (1n << 127n) - 1n;
+var LP_ECONOMIC_UNSIGNED_DECIMAL = /^(0|[1-9][0-9]*)$/;
+var LP_ECONOMIC_SIGNED_DECIMAL = /^(0|-?[1-9][0-9]*)$/;
+function mapLpEconomicReturn(summary) {
+  const unsigned = [
+    summary.provider_reward_lamports,
+    summary.source_expense_compensation_lamports,
+    summary.charged_reimbursement_loss_lamports
+  ];
+  const valid = unsigned.every(
+    (value) => typeof value === "string" && LP_ECONOMIC_UNSIGNED_DECIMAL.test(value) && BigInt(value) <= LP_ECONOMIC_UNSIGNED_TOTAL_MAX
+  ) && typeof summary.net_economic_return_lamports === "string" && LP_ECONOMIC_SIGNED_DECIMAL.test(summary.net_economic_return_lamports);
+  if (!valid)
+    throw new CommandError("REJECTED_STATE", "coordinator LP economic return totals are invalid");
+  const net = BigInt(summary.net_economic_return_lamports);
+  if (net < LP_ECONOMIC_SIGNED_TOTAL_MIN || net > LP_ECONOMIC_SIGNED_TOTAL_MAX || net !== BigInt(summary.provider_reward_lamports) - BigInt(summary.charged_reimbursement_loss_lamports)) {
+    throw new CommandError("REJECTED_STATE", "coordinator LP economic return invariant is invalid");
+  }
+  return {
+    providerRewardLamports: summary.provider_reward_lamports,
+    sourceExpenseCompensationLamports: summary.source_expense_compensation_lamports,
+    chargedReimbursementLossLamports: summary.charged_reimbursement_loss_lamports,
+    netEconomicReturnLamports: summary.net_economic_return_lamports
+  };
+}
 function mergePositionHistoryPages(first, next) {
   if (first.actorSync === void 0) return next;
   if (next.actorSync === void 0) return first;
@@ -955,7 +1077,7 @@ function randomBytes(length) {
   return bytes;
 }
 function loadProtocol() {
-  protocolPromise ??= import('./coordinator-E2TS6NR2.js');
+  protocolPromise ??= import('./coordinator-DHL3AP7V.js');
   return protocolPromise;
 }
 
@@ -1327,7 +1449,7 @@ function createLpLifecycleClient(session, runtime = {}) {
       const current = rememberPosition(await client.getPosition(positionId, auth));
       options.onPosition?.(current);
       const startIndex = current.shards.length;
-      const remaining = current.targetShardCount - startIndex;
+      const remaining = Math.min(current.targetShardCount - startIndex, LP_MAX_INITIAL_SHARDS);
       if (remaining <= 0) return current;
       emitDkgProgress(options, current, startIndex, remaining, 0);
       let expectedAddresses = null;
@@ -1357,7 +1479,9 @@ function createLpLifecycleClient(session, runtime = {}) {
         );
         options.onPosition?.(position);
         emitDkgProgress(options, position, startIndex, remaining, remaining);
-        return rememberPosition(position);
+        rememberPosition(position);
+        if (position.shards.length < position.targetShardCount) continue;
+        return position;
       } catch (error) {
         const reconciled = await tryRefreshCompletedDkgWindow({
           client,
@@ -1387,7 +1511,7 @@ function createLpLifecycleClient(session, runtime = {}) {
     async createPosition(args) {
       assertNoUnsupportedFeePolicy(args.feePolicy);
       const shardCount = args.shardCount ?? LP_DEFAULT_TARGET_SHARDS;
-      assertShardCount(shardCount, LP_MAX_TARGET_SHARDS, "shardCount");
+      assertShardCount(shardCount, LP_MAX_INITIAL_SHARDS, "shardCount");
       assertAttested(currentSession);
       const committedLamports = args.committedLamports ?? DEFAULT_SHARD_FUNDING_LAMPORTS;
       const refillThreshold = args.refillThreshold ?? Math.ceil(shardCount * DEFAULT_REFILL_THRESHOLD_RATIO);
@@ -1448,11 +1572,7 @@ function createLpLifecycleClient(session, runtime = {}) {
       const auth = requireAuth(positionId);
       const current = await refreshPosition2(positionId);
       args.onPosition?.(current);
-      const refillShardCount = resolveLpRefillShardCount(
-        current,
-        requestedShardCount,
-        args.shardCount === void 0
-      );
+      const refillShardCount = resolveLpRefillShardCount(current, requestedShardCount);
       const authorizedPosition = rememberPosition(
         await client.refillPosition(
           {
@@ -1785,21 +1905,12 @@ function assertShardCount(value, max, field) {
     );
   }
 }
-function resolveLpRefillShardCount(position, requestedShardCount, capDefaultBatch) {
-  const remainingShardCapacity = LP_MAX_TARGET_SHARDS - position.shards.length;
-  if (remainingShardCapacity <= 0) {
-    throw new PolicyValidationError(
-      "INVALID_AMOUNT",
-      `LP refill target_shard_count is already at ${LP_MAX_TARGET_SHARDS}`
-    );
-  }
-  const refillShardCount = capDefaultBatch ? Math.min(requestedShardCount, remainingShardCapacity) : requestedShardCount;
-  if (position.shards.length + refillShardCount > LP_MAX_TARGET_SHARDS) {
-    throw new PolicyValidationError(
-      "INVALID_AMOUNT",
-      `LP refill target_shard_count must be <= ${LP_MAX_TARGET_SHARDS}`
-    );
+function resolveLpRefillShardCount(position, requestedShardCount) {
+  const nextTarget = position.shards.length + requestedShardCount;
+  if (!Number.isSafeInteger(nextTarget) || nextTarget > LP_MAX_TOTAL_SHARDS) {
+    throw new PolicyValidationError("INVALID_AMOUNT", "LP refill target_shard_count overflows u32");
   }
+  const refillShardCount = requestedShardCount;
   return refillShardCount;
 }
 function isLpPositionReadyForInitialFunding(position) {
@@ -2017,6 +2128,7 @@ function reconcileLpRedemptionFromHistory(record, history) {
     ...record,
     coordinatorStateVersion: history.stateVersion,
     redeemedLamports: history.landedLamports,
+    networkFeeLossLamports: history.networkFeeLossLamports,
     txSignatures,
     destinationCount: history.destinationCount,
     txSignatureCount: history.txSignatureCount,
@@ -2063,6 +2175,7 @@ function lpWithdrawalRecordFromHistory(position, history) {
     landedBaselineLamports: 0,
     landedFeeBaselineLamports: 0,
     redeemedLamports: history.landedLamports,
+    networkFeeLossLamports: history.networkFeeLossLamports,
     txSignatures: [...history.txSignatures],
     txSignatureBaseline: [],
     coordinatorStateVersion: history.stateVersion,