@invisible-labs/sdk 0.13.2-devnet → 0.13.3-devnet

package/dist/{coordinator-EQEL23A3.js → coordinator-MLBKEKGO.js}

@@ -1,4 +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, LP_FEE_POLICY_HASHES, LP_FEE_POLICY_VERSION, LP_PARTNER_COMMISSION_BPS, 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, validateLpFeePolicySemantics } from './chunk-M45APS7S.js';
+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, LP_FEE_POLICY_HASHES, LP_FEE_POLICY_VERSION, LP_PARTNER_COMMISSION_BPS, 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, validateLpFeePolicySemantics } from './chunk-7CUZ7NWC.js';
 import './chunk-VR6T6OJS.js';
-//# sourceMappingURL=coordinator-EQEL23A3.js.map
-//# sourceMappingURL=coordinator-EQEL23A3.js.map
+//# sourceMappingURL=coordinator-MLBKEKGO.js.map
+//# sourceMappingURL=coordinator-MLBKEKGO.js.map

package/dist/{coordinator-EQEL23A3.js.map → coordinator-MLBKEKGO.js.map}

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

package/dist/events.js

@@ -1,4 +1,4 @@
-import { onEnvelope, EnvelopeKind, CoordinatorMessageType } from './chunk-NOKBFHDP.js';
+import { onEnvelope, EnvelopeKind, CoordinatorMessageType } from './chunk-5YOVJLHU.js';
 import './chunk-DOTYDYVB.js';
 import { NotImplementedError } from './chunk-A4R3DHKN.js';
 import './chunk-VR6T6OJS.js';

package/dist/index.js

@@ -105,7 +105,7 @@ function createAzureProductionEndpoint({
 }
 
 // src/presets/productionBinaryHash.ts
-var APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH = "00ee3347615c4a38199e16d715b3f554af2e752338f57e7149a813fe0d4b4451".toLowerCase() ;
+var APPROVED_PRODUCTION_COORDINATOR_BINARY_HASH = "f2b8d35551cbf849d25d0ea297c6e5da85482e69ff6fcafc5d021b134f42a00c".toLowerCase() ;
 
 // src/presets/productionMrtd.ts
 var APPROVED_PRODUCTION_COORDINATOR_MRTD = "efef2fafedab1cecacab0acbb3ec70ab6638b474a4469022745c1c8ba0470be4cfa1170ad5c82f57bff4833acde55e4c".toLowerCase() ;

package/dist/lp.d.ts

@@ -57,6 +57,21 @@ type LpPositionView = {
     redemptionPermission?: LpRedemptionPermission;
     actorSync?: LpActorSyncView;
 };
+type LpShardStatus = LpInventoryShard["status"];
+type LpShardStatusTotal = {
+    readonly count: number;
+    readonly lamports: number;
+};
+/**
+ * Bounded, atomic LP position summary. It is deliberately not an `LpPositionView`:
+ * `shards` is readonly and holds at most the index 0 shard and the lowest-index
+ * FUNDING_QUEUED shard, so it must never feed code that needs the full inventory.
+ */
+type LpPositionSummaryView = Omit<LpPositionView, "shards"> & {
+    readonly shardsTotalCount: number;
+    readonly shardTotals: Readonly<Record<LpShardStatus, LpShardStatusTotal>>;
+    readonly shards: readonly LpInventoryShard[];
+};
 type LpRedemptionPermission = {
     state: "unknown" | "locked" | "enabled";
     grantRevision: number;
@@ -234,9 +249,13 @@ type LpCoordinatorClient = LpDkgClient & {
     authorizePositionCreation(intent: LpPositionCreationIntent, signer: LpCreationSigner): Promise<LpCreationAuthorization>;
     openPosition(input: OpenLpPositionInput, auth: LpPositionCodeAuth): Promise<LpPositionView>;
     getPosition(lpPositionId: string, auth: LpPositionCodeAuth, options?: LpPositionRequestOptions): Promise<LpPositionView>;
+    /** One bounded `position_get` with `view: "summary"`; older coordinators reject it. */
+    getPositionSummary(lpPositionId: string, auth: LpPositionCodeAuth, options?: LpPositionSummaryRequestOptions): Promise<LpPositionSummaryView>;
     finalizeDkgBatch(input: FinalizeLpDkgBatchInput, auth: LpPositionCodeAuth): Promise<LpPositionView>;
     refillPosition(input: RefillLpPositionInput, auth: LpPositionCodeAuth): Promise<LpPositionView>;
     reconcileFunding(lpPositionId: string, auth: LpPositionCodeAuth): Promise<LpPositionView>;
+    /** `reconcile_funding` with `view: "summary"`: same reconciliation, bounded summary reply. */
+    reconcileFundingSummary(lpPositionId: string, auth: LpPositionCodeAuth, options?: LpPositionSummaryRequestOptions): Promise<LpPositionSummaryView>;
     planFunding(input: {
         lpPositionId: string;
         shardCount: number;
@@ -269,14 +288,24 @@ interface LpPositionRequestOptions {
     readonly signal?: AbortSignal;
     readonly timeoutMs?: number;
 }
+interface LpPositionSummaryRequestOptions extends LpPositionRequestOptions {
+    /**
+     * `"all"` (default) follows every redemption history cursor; `"first_page"` returns one
+     * request and keeps `redemptionHistoryHasMore` and its cursor.
+     */
+    readonly redemptionHistory?: "all" | "first_page";
+}
 
 /** Invalid optional totals must not discard the position or its authorities. */
 declare function normalizeLpActorSync(sync: LpActorSyncView): LpActorSyncView;
 /** Keep one coherent actor projection when concurrent reads arrive out of order. */
 declare function mergeLpActorSync(previous: LpActorSyncView | undefined, next: LpActorSyncView | undefined): LpActorSyncView | undefined;
 
+declare const LP_POSITION_SUMMARY_SCHEMA_REJECTION_PREFIX = "json schema validation failed: ";
+declare const LP_POSITION_SUMMARY_SCHEMA_REJECTION_VIEW_TOKEN = "\"view\":\"summary\"";
 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_WITHDRAWAL_FULL_INVENTORY_REQUIRED_MESSAGE = "LP withdrawal plan requires the full shard inventory";
 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";
@@ -377,6 +406,15 @@ interface WithdrawPositionResult {
     readonly position: LpPositionView;
     readonly redemption: LpWithdrawalRecord;
 }
+/** Summary-path withdrawal result: never carries a full `LpPositionView`. */
+interface WithdrawPositionSummaryResult {
+    readonly execution: WithdrawalExecution;
+    readonly summary: LpPositionSummaryView;
+    readonly redemption: LpWithdrawalRecord;
+}
+type WaitForWithdrawalSummaryConfirmationOptions = Omit<WaitForWithdrawalConfirmationOptions, "onPosition"> & {
+    readonly onSummary?: (summary: LpPositionSummaryView) => void;
+};
 interface WithdrawalConfirmation {
     readonly withdrawalId: string;
     readonly txSignatures: string[];
@@ -424,10 +462,23 @@ interface LpWithdrawalPlanPreview {
 }
 declare function isLpRedemptionReconcilingError(error: unknown): boolean;
 declare function isLpPositionAuthMissingError(error: unknown): boolean;
+/** True only for the schema rejection an older coordinator returns for `view: "summary"`. */
+declare function isLpPositionSummaryUnsupportedError(error: unknown): boolean;
 declare function previewLpWithdrawalPlan(position: LpPositionView, args?: LpWithdrawalPlanPreviewArgs): LpWithdrawalPlanPreview;
+/**
+ * Same preview as `previewLpWithdrawalPlan`, from a bounded summary. Throws
+ * `LP_WITHDRAWAL_FULL_INVENTORY_REQUIRED_MESSAGE` when the result would depend on individual
+ * AVAILABLE shards; it never approximates from status totals or the summary shards.
+ */
+declare function previewLpWithdrawalPlanFromSummary(summary: LpPositionSummaryView, args?: LpWithdrawalPlanPreviewArgs): LpWithdrawalPlanPreview;
 interface LpLifecycleClient {
     createPosition(args: CreatePositionArgs): Promise<CreatePositionResult>;
     recoverPosition(args: RecoverPositionArgs): Promise<LpPositionView>;
+    /**
+     * One bounded summary read. Falls back to full `recoverPosition` hydration only when the
+     * coordinator rejects the summary view with `ERR_INVALID_PAYLOAD` (older coordinator).
+     */
+    recoverPositionSummary(args: RecoverPositionArgs): Promise<LpPositionSummaryView>;
     confirmPositionCodeSaved(positionId: string): void;
     completeDkgBatch(positionId: string, options?: CompleteDkgBatchOptions): Promise<LpPositionView>;
     refreshPosition(positionId: string): Promise<LpPositionView>;
@@ -436,8 +487,20 @@ interface LpLifecycleClient {
     prepareTopUp(positionId: string): Promise<LpTopUpRequest>;
     waitForTopUp(topUpId: string, options?: WaitForTopUpOptions): Promise<LpTopUpRequest>;
     reconcileFunding(positionId: string): Promise<LpPositionView>;
+    /** Funding reconcile replying with the bounded summary (first redemption history page). */
+    reconcileFundingSummary(positionId: string): Promise<LpPositionSummaryView>;
+    /** Summary read with the remembered auth; `redemptionHistory: "all"` follows every cursor. */
+    refreshPositionSummary(positionId: string, options?: Pick<LpPositionSummaryRequestOptions, "redemptionHistory">): Promise<LpPositionSummaryView>;
     withdrawPosition(positionId: string, args: WithdrawPositionArgs): Promise<WithdrawPositionResult>;
+    /**
+     * Withdrawal planned from a bounded summary (reconciled with `view: "summary"`). Falls back to
+     * `withdrawPosition` when the coordinator predates the summary view or when the plan would
+     * depend on individual AVAILABLE shards.
+     */
+    withdrawPositionSummary(positionId: string, args: WithdrawPositionArgs): Promise<WithdrawPositionSummaryResult>;
     waitForWithdrawalConfirmation(positionId: string, execution: WithdrawalExecution, options?: WaitForWithdrawalConfirmationOptions): Promise<WithdrawalConfirmation>;
+    /** Confirms only from the tracked redemption id in the fully paged summary history. */
+    waitForWithdrawalConfirmationSummary(positionId: string, execution: WithdrawalExecution, options?: WaitForWithdrawalSummaryConfirmationOptions): Promise<WithdrawalConfirmation>;
     withdrawFees(positionId: string, args: {
         readonly destination: string;
     }): Promise<never>;
@@ -455,6 +518,12 @@ type LpCoordinatorClientOptions = {
 };
 declare function createLpCoordinatorClient(session: Session, options?: LpCoordinatorClientOptions): LpCoordinatorClient;
 
+/** Upper bound on `LpPositionSummaryView.shards`: index 0 plus one FUNDING_QUEUED shard. */
+declare const LP_POSITION_SUMMARY_MAX_SHARDS = 2;
+declare const LP_SHARD_STATUSES: readonly ["PREGENERATED", "FUNDING_QUEUED", "FUNDED", "COOLING", "AVAILABLE", "RESERVED", "RETIRED", "REDEEMED"];
+/** Derives the bounded summary from a fully hydrated position (older-coordinator fallback). */
+declare function summarizeLpPosition(position: LpPositionView): LpPositionSummaryView;
+
 type LpDkgProgress = {
     completed: number;
     total: number;
@@ -477,10 +546,11 @@ 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 validateLpPositionFeePolicy(position: LpPositionView, previous?: LpPositionView): void;
+declare function validateLpPositionFeePolicy(position: Pick<LpPositionView, "feePolicy" | "lpFeePolicyVersion" | "id" | "actorSync">, previous?: Pick<LpPositionView, "feePolicy">): void;
 
 declare function createPosition(session: Session, args: CreatePositionArgs): Promise<CreatePositionResult>;
 declare function recoverPosition(session: Session, args: RecoverPositionArgs): Promise<LpPositionView>;
+declare function recoverPositionSummary(session: Session, args: RecoverPositionArgs): Promise<LpPositionSummaryView>;
 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>;
@@ -490,6 +560,9 @@ declare function prepareTopUp(session: Session, positionId: string): Promise<LpT
 declare function waitForTopUp(session: Session, topUpId: string, options?: WaitForTopUpOptions): Promise<LpTopUpRequest>;
 declare function reconcileFunding(session: Session, positionId: string): Promise<LpPositionView>;
 declare function withdrawPosition(session: Session, positionId: string, args: WithdrawPositionArgs): Promise<WithdrawPositionResult>;
+declare function reconcileFundingSummary(session: Session, positionId: string): Promise<LpPositionSummaryView>;
+declare function withdrawPositionSummary(session: Session, positionId: string, args: WithdrawPositionArgs): Promise<WithdrawPositionSummaryResult>;
+declare function waitForWithdrawalConfirmationSummary(session: Session, positionId: string, execution: WithdrawalExecution, options?: WaitForWithdrawalSummaryConfirmationOptions): Promise<WithdrawalConfirmation>;
 declare function waitForWithdrawalConfirmation(session: Session, positionId: string, execution: WithdrawalExecution, options?: WaitForWithdrawalConfirmationOptions): Promise<WithdrawalConfirmation>;
 /**
  * LP fee withdrawal is coordinator-pending. The SDK validates the local input
@@ -500,4 +573,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 LpEconomicReturnSummary, type LpFeePolicy, 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, mergeLpActorSync, normalizeLpActorSync, normalizeLpPositionCode, prepareInitialFunding, prepareTopUp, previewLpWithdrawalPlan, reconcileFunding, recoverPosition, refill, refreshPosition, signLpCommandBytes, validateLpPositionFeePolicy, 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_POSITION_SUMMARY_MAX_SHARDS, LP_POSITION_SUMMARY_SCHEMA_REJECTION_PREFIX, LP_POSITION_SUMMARY_SCHEMA_REJECTION_VIEW_TOKEN, LP_REDEMPTION_RECONCILING_MESSAGE, LP_SHARD_STATUSES, LP_WITHDRAWAL_FULL_INVENTORY_REQUIRED_MESSAGE, type LpActorSyncView, type LpCoordinatorClient, type LpCoordinatorClientOptions, type LpCreationAuthorization, type LpCreationSigner, type LpDkgClient, type LpDkgProgress, type LpEconomicReturnSummary, type LpFeePolicy, type LpInventoryShard, type LpLifecycleClient, type LpLifecycleDkgProgress, type LpLifecycleRuntime, type LpPositionCode, type LpPositionCodeAuth, type LpPositionCreationIntent, type LpPositionRequestOptions, type LpPositionSummaryRequestOptions, type LpPositionSummaryView, type LpPositionView, type LpRedemptionHistoryView, type LpRedemptionPermission, type LpShardStatus, type LpShardStatusTotal, 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 WaitForWithdrawalSummaryConfirmationOptions, type WithdrawPositionArgs, type WithdrawPositionResult, type WithdrawPositionSummaryResult, type WithdrawalConfirmation, type WithdrawalExecution, bytesToHex, completeDkgBatch, confirmPositionCodeSaved, createLpCoordinatorClient, createLpDkgBatch, createLpLifecycleClient, createPosition, defaultLpLifecycleClient, deriveLpPositionCodeAuth, generateLpPositionCode, isLpPositionAuthMissingError, isLpPositionSummaryUnsupportedError, isLpRedemptionReconcilingError, listPositions, mergeLpActorSync, normalizeLpActorSync, normalizeLpPositionCode, prepareInitialFunding, prepareTopUp, previewLpWithdrawalPlan, previewLpWithdrawalPlanFromSummary, reconcileFunding, reconcileFundingSummary, recoverPosition, recoverPositionSummary, refill, refreshPosition, signLpCommandBytes, summarizeLpPosition, validateLpPositionFeePolicy, waitForTopUp, waitForWithdrawalConfirmation, waitForWithdrawalConfirmationSummary, withdrawFees, withdrawPosition, withdrawPositionSummary };