@pear-protocol/types 2.9.0 → 2.11.0

package/dist/bundle.d.ts

@@ -30,3 +30,4 @@ export * from './trade-accounts';
 export * from './trigger';
 export * from './triggers';
 export * from './users';
+export * from './vaults';

package/dist/bundle.js

@@ -30,3 +30,4 @@ export * from './trade-accounts';
 export * from './trigger';
 export * from './triggers';
 export * from './users';
+export * from './vaults';

package/dist/common/address.d.ts

@@ -1,3 +1,9 @@
 import { z } from 'zod';
-export type EthereumAddress = `0x${string}`;
-export declare const EthereumAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+/**
+ * A validated, lowercase Ethereum address. The zod schema below is the only
+ * mint point: interior code may assume lowercase and must never re-normalize.
+ */
+export type EthereumAddress = `0x${string}` & {
+    readonly __lowercaseAddress: true;
+};
+export declare const EthereumAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;

package/dist/position/responses.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { EthereumAddress } from '../common/address';
 export declare const PositionListResponse: z.ZodObject<{
     limit: z.ZodNumber;
     nextCursor: z.ZodOptional<z.ZodString>;
@@ -305,7 +306,7 @@ export type OpenPositionListResponse = z.output<typeof OpenPositionListResponse>
 export declare const VaultOpenPositionListResponse: z.ZodObject<{
     limit: z.ZodNumber;
     nextCursor: z.ZodOptional<z.ZodString>;
-    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     positions: z.ZodArray<z.ZodObject<{
         status: z.ZodLiteral<"OPEN">;
         connector: z.ZodEnum<{
@@ -351,7 +352,7 @@ export type VaultOpenPositionListResponse = z.output<typeof VaultOpenPositionLis
 export declare const VaultClosedPositionListResponse: z.ZodObject<{
     limit: z.ZodNumber;
     nextCursor: z.ZodOptional<z.ZodString>;
-    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     positions: z.ZodArray<z.ZodObject<{
         status: z.ZodLiteral<"CLOSED">;
         connector: z.ZodEnum<{

package/dist/sync/payloads.d.ts

@@ -359,8 +359,18 @@ export declare const CreateApplicablesMeta: z.ZodObject<{
     externalMaxTs: z.ZodNullable<z.ZodNumber>;
     firstSyncStartedAt: z.ZodOptional<z.ZodNumber>;
     newestFillTs: z.ZodOptional<z.ZodNumber>;
+    executionsUpdatedAtEpochMs: z.ZodNumber;
 }, z.core.$strip>;
 export type CreateApplicablesMeta = z.output<typeof CreateApplicablesMeta>;
+/**
+ * Plain multipart fields posted beside the gzipped create payload on the bulk route.
+ * Core forwards the gzip unread, so any meta its own admission gates need must travel
+ * outside it; multipart fields arrive as strings.
+ */
+export declare const CreateApplicablesBulkFields: z.ZodObject<{
+    executionsUpdatedAtEpochMs: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
+}, z.core.$strip>;
+export type CreateApplicablesBulkFields = z.output<typeof CreateApplicablesBulkFields>;
 /**
  * POST /sync/create request — the discover+apply phase of the cycle.
  * - applicables: baskets keyed by positionKey, find-or-created during apply.
@@ -442,6 +452,7 @@ export declare const CreateApplicablesRequest: z.ZodObject<{
         externalMaxTs: z.ZodNullable<z.ZodNumber>;
         firstSyncStartedAt: z.ZodOptional<z.ZodNumber>;
         newestFillTs: z.ZodOptional<z.ZodNumber>;
+        executionsUpdatedAtEpochMs: z.ZodNumber;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type CreateApplicablesRequest = z.output<typeof CreateApplicablesRequest>;

package/dist/sync/payloads.js

@@ -114,7 +114,11 @@ const SyncMeta = z.object({
 });
 const CreateApplicablesMeta = SyncMeta.extend({
   firstSyncStartedAt: z.number().int().nonnegative().optional().describe("backend-issued timestamp returned before the first fill-history fetch"),
-  newestFillTs: z.number().int().nonnegative().refine((timestamp) => timestamp <= Date.now() + WATERMARK_FUTURE_SKEW_MS, "newestFillTs must not be ahead of server time").optional().describe("raw newest fetched fill \u2014 settle-gate source, never trim-advanced")
+  newestFillTs: z.number().int().nonnegative().refine((timestamp) => timestamp <= Date.now() + WATERMARK_FUTURE_SKEW_MS, "newestFillTs must not be ahead of server time").optional().describe("raw newest fetched fill \u2014 settle-gate source, never trim-advanced"),
+  executionsUpdatedAtEpochMs: z.number().int().nonnegative().describe("verbatim echo of fills/since executionsUpdatedAtEpochMs \u2014 stale-read gate token, not a client clock")
+});
+const CreateApplicablesBulkFields = z.object({
+  executionsUpdatedAtEpochMs: z.string().regex(/^\d+$/, "Must be a non-negative integer millisecond value").transform(Number).describe("mirror of meta.executionsUpdatedAtEpochMs, readable without decompressing the payload")
 });
 const CreateApplicablesRequest = z.object({
   applicables: z.array(ApplicablePosition),
@@ -135,4 +139,4 @@ const CreateFundingPaymentsRequest = z.object({
   meta: SyncMeta
 });
 
-export { ApplicableFill, ApplicableMetadata, ApplicablePosition, ConfirmFillsRequest, ConfirmableExternalFill, CreateApplicablesMeta, CreateApplicablesRequest, CreateFundingPaymentsRequest, ExternalPosition, FundingPaymentEntry, ReconcileFillsRequest, ReconcileReplacementExternalFill, SyncFillsSinceRequest, SyncFundingSinceRequest, SyncMeta, UnknownExternalFill, WATERMARK_FUTURE_SKEW_MS };
+export { ApplicableFill, ApplicableMetadata, ApplicablePosition, ConfirmFillsRequest, ConfirmableExternalFill, CreateApplicablesBulkFields, CreateApplicablesMeta, CreateApplicablesRequest, CreateFundingPaymentsRequest, ExternalPosition, FundingPaymentEntry, ReconcileFillsRequest, ReconcileReplacementExternalFill, SyncFillsSinceRequest, SyncFundingSinceRequest, SyncMeta, UnknownExternalFill, WATERMARK_FUTURE_SKEW_MS };

package/dist/sync/responses.d.ts

@@ -5,6 +5,7 @@ export declare const SyncFillsSinceResponse: z.ZodObject<{
     neverSynced: z.ZodBoolean;
     firstSyncStartedAt: z.ZodOptional<z.ZodNumber>;
     confirmedExchangeFillIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    executionsUpdatedAtEpochMs: z.ZodNumber;
 }, z.core.$strip>;
 export declare const SyncFundingSinceResponse: z.ZodObject<{
     sinceMs: z.ZodNumber;

package/dist/sync/responses.js

@@ -10,7 +10,14 @@ const SyncFillsSinceResponse = z.object({
   // Backend-clock boundary returned only for a never-synced account. The syncer carries this
   // through when an empty exchange fetch provides no fill-derived checkpoint.
   firstSyncStartedAt: z.number().int().nonnegative().optional(),
-  confirmedExchangeFillIds: z.array(z.string()).optional()
+  confirmedExchangeFillIds: z.array(z.string()).optional(),
+  // Newest executions.updatedAt this response can have observed, as epoch ms ceiled to the next
+  // whole millisecond (the column keeps microseconds); 0 when the account has no executions. The
+  // client echoes it verbatim in the create meta — core defers the create when any execution
+  // write postdates it. No client clock on the wire: ordering is against our own persisted
+  // updated_at values (Postgres now() on insert, the engine's clock on updates — the settle
+  // gate covers skew between those writers).
+  executionsUpdatedAtEpochMs: z.number().int().nonnegative()
 });
 const SyncFundingSinceResponse = z.object({
   sinceMs: z.number().int().nonnegative()

package/dist/trade-accounts/payloads.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { EthereumAddress } from '../common/address';
 /**
  * Hyperliquid connector credentials
  */
@@ -9,9 +10,9 @@ declare const CreateHyperliquidCredentials: z.ZodObject<{
  * Hyperliquid connector metadata
  */
 declare const CreateHyperliquidMetadata: z.ZodObject<{
-    agentWalletAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    agentWalletAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     isSubaccount: z.ZodBoolean;
-    mainAccountAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    mainAccountAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
 }, z.core.$strip>;
 declare const CreateBinanceCredentials: z.ZodObject<{
     read: z.ZodObject<{
@@ -49,7 +50,7 @@ declare const CreateLighterCredentials: z.ZodObject<{
  * Lighter connector metadata
  */
 declare const CreateLighterMetadata: z.ZodObject<{
-    l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
 }, z.core.$strip>;
 /**
  * Payload to create a new trade account
@@ -57,14 +58,14 @@ declare const CreateLighterMetadata: z.ZodObject<{
 export declare const CreateTradeAccount: z.ZodDiscriminatedUnion<[z.ZodObject<{
     connector: z.ZodLiteral<"hyperliquid">;
     alias: z.ZodString;
-    exchangeIdentifier: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    exchangeIdentifier: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     credentials: z.ZodObject<{
         signer_key: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     }, z.core.$strip>;
     metadata: z.ZodObject<{
-        agentWalletAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        agentWalletAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
         isSubaccount: z.ZodBoolean;
-        mainAccountAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        mainAccountAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     connector: z.ZodLiteral<"binance">;
@@ -106,7 +107,7 @@ export declare const CreateTradeAccount: z.ZodDiscriminatedUnion<[z.ZodObject<{
         api_key_index: z.ZodNumber;
     }, z.core.$strip>;
     metadata: z.ZodObject<{
-        l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     alias: z.ZodString;
@@ -116,7 +117,7 @@ export declare const CreateTradeAccount: z.ZodDiscriminatedUnion<[z.ZodObject<{
         api_key_index: z.ZodNumber;
     }, z.core.$strip>;
     metadata: z.ZodObject<{
-        l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     }, z.core.$strip>;
     connector: z.ZodLiteral<"lighter_rhc">;
 }, z.core.$strip>], "connector">;
@@ -126,7 +127,7 @@ export declare const CreateTradeAccount: z.ZodDiscriminatedUnion<[z.ZodObject<{
  * the payload carries no credentials.
  */
 export declare const CreateVaultTradeAccount: z.ZodObject<{
-    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     alias: z.ZodString;
     idempotencyKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -140,9 +141,9 @@ export declare const UpdateTradeAccount: z.ZodDiscriminatedUnion<[z.ZodObject<{
         signer_key: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     }, z.core.$strip>>;
     metadata: z.ZodOptional<z.ZodObject<{
-        agentWalletAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        agentWalletAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
         isSubaccount: z.ZodBoolean;
-        mainAccountAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        mainAccountAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     connector: z.ZodLiteral<"binance">;
@@ -183,7 +184,7 @@ export declare const UpdateTradeAccount: z.ZodDiscriminatedUnion<[z.ZodObject<{
         api_key_index: z.ZodNumber;
     }, z.core.$strip>>;
     metadata: z.ZodOptional<z.ZodObject<{
-        l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     alias: z.ZodOptional<z.ZodString>;
@@ -192,7 +193,7 @@ export declare const UpdateTradeAccount: z.ZodDiscriminatedUnion<[z.ZodObject<{
         api_key_index: z.ZodNumber;
     }, z.core.$strip>>;
     metadata: z.ZodOptional<z.ZodObject<{
-        l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
     }, z.core.$strip>>;
     connector: z.ZodLiteral<"lighter_rhc">;
 }, z.core.$strip>], "connector">;

package/dist/users/entities.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { EthereumAddress } from '../common/address';
 export declare const UserPreferences: z.ZodObject<{
     slippageToleranceBps: z.ZodInt;
 }, z.core.$strip>;
@@ -22,24 +23,24 @@ export type UserPreferences = z.infer<typeof UserPreferences>;
 export type UserProfile = z.infer<typeof UserProfile>;
 export declare const BoundReferralReferee: z.ZodObject<{
     status: z.ZodLiteral<"BOUND">;
-    address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>>;
     referredAt: z.ZodOptional<z.ZodNumber>;
     tradeCount: z.ZodNumber;
     volumeUsd: z.ZodString;
 }, z.core.$strip>;
 export declare const PendingReferralReferee: z.ZodObject<{
     status: z.ZodLiteral<"PENDING">;
-    address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    address: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
 }, z.core.$strip>;
 export declare const ReferralReferee: z.ZodDiscriminatedUnion<[z.ZodObject<{
     status: z.ZodLiteral<"BOUND">;
-    address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>>;
     referredAt: z.ZodOptional<z.ZodNumber>;
     tradeCount: z.ZodNumber;
     volumeUsd: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     status: z.ZodLiteral<"PENDING">;
-    address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    address: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
 }, z.core.$strip>], "status">;
 export type BoundReferralReferee = z.infer<typeof BoundReferralReferee>;
 export type PendingReferralReferee = z.infer<typeof PendingReferralReferee>;

package/dist/users/response.d.ts

@@ -44,13 +44,13 @@ export declare const ReferralRefereeListResponse: z.ZodObject<{
     totalVolumeUsd: z.ZodString;
     referees: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         status: z.ZodLiteral<"BOUND">;
-        address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+        address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("..").EthereumAddress, string>>>;
         referredAt: z.ZodOptional<z.ZodNumber>;
         tradeCount: z.ZodNumber;
         volumeUsd: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         status: z.ZodLiteral<"PENDING">;
-        address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        address: z.ZodPipe<z.ZodString, z.ZodTransform<import("..").EthereumAddress, string>>;
     }, z.core.$strip>], "status">>;
 }, z.core.$strip>;
 export type ReferralRefereeListResponse = z.infer<typeof ReferralRefereeListResponse>;

package/dist/vaults/entities.d.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+import { EthereumAddress } from '../common/address';
+/** Lifecycle state of a vault. */
+export declare const VaultStatus: z.ZodEnum<{
+    active: "active";
+    inactive: "inactive";
+    pending_activation: "pending_activation";
+}>;
+export type VaultStatus = z.infer<typeof VaultStatus>;
+/** Browser-facing projection of a vault row, matching core's public camelCase API. */
+export declare const Vault: z.ZodObject<{
+    id: z.ZodString;
+    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    ownerAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    traderAddress: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>>;
+    agentAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    status: z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+        pending_activation: "pending_activation";
+    }>;
+    isApproved: z.ZodBoolean;
+    name: z.ZodNullable<z.ZodString>;
+    about: z.ZodNullable<z.ZodString>;
+    imageUrl: z.ZodNullable<z.ZodString>;
+    transactionHash: z.ZodNullable<z.ZodString>;
+    maxWithdrawalPeriodDays: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Vault = z.infer<typeof Vault>;
+/** One durable operation row in a vault's activity ledger. */
+export declare const Activity: z.ZodObject<{
+    id: z.ZodString;
+    vaultAddress: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        "vault.create": "vault.create";
+        "vault.set_trader": "vault.set_trader";
+        "vault.update_metadata": "vault.update_metadata";
+        "bridge.withdraw_to_evm": "bridge.withdraw_to_evm";
+    }>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        pending: "pending";
+        succeeded: "succeeded";
+    }>;
+    txHash: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type Activity = z.infer<typeof Activity>;
+/** Indexed on-chain deposit/withdrawal event for a vault. */
+export declare const VaultEvent: z.ZodObject<{
+    id: z.ZodString;
+    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    eventType: z.ZodEnum<{
+        DEPOSIT: "DEPOSIT";
+        WITHDRAWAL: "WITHDRAWAL";
+    }>;
+    userAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    receiver: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    assets: z.ZodString;
+    shares: z.ZodString;
+    fee: z.ZodString;
+    withdrawalId: z.ZodNullable<z.ZodString>;
+    txHash: z.ZodString;
+    blockNumber: z.ZodString;
+    logIndex: z.ZodNumber;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type VaultEvent = z.infer<typeof VaultEvent>;
+/** Most recent NAV snapshot of a vault. */
+export declare const NavSnapshot: z.ZodObject<{
+    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    takenAt: z.ZodString;
+    totalAssets: z.ZodString;
+    totalSupply: z.ZodString;
+    sharePrice: z.ZodString;
+    blockNumber: z.ZodString;
+}, z.core.$strip>;
+export type NavSnapshot = z.infer<typeof NavSnapshot>;
+/** One fixed-resolution NAV point in a range read. */
+export declare const NavBucketPoint: z.ZodObject<{
+    bucket: z.ZodISODateTime;
+    totalAssets: z.ZodString;
+    totalSupply: z.ZodString;
+    sharePrice: z.ZodString;
+    blockNumber: z.ZodString;
+}, z.core.$strip>;
+export type NavBucketPoint = z.infer<typeof NavBucketPoint>;
+/** Sparse bulk-read NAV point; only the requested fields carry values. */
+export declare const BulkSnapshotPoint: z.ZodObject<{
+    timestamp: z.ZodNumber;
+    createdAt: z.ZodString;
+    tvl: z.ZodOptional<z.ZodString>;
+    sharePrice: z.ZodOptional<z.ZodString>;
+    accountValue: z.ZodOptional<z.ZodNull>;
+    unrealizedPnl: z.ZodOptional<z.ZodNull>;
+    cumulativeRealizedPnl: z.ZodOptional<z.ZodNull>;
+    leaderSharePct: z.ZodOptional<z.ZodNull>;
+}, z.core.$strip>;
+export type BulkSnapshotPoint = z.infer<typeof BulkSnapshotPoint>;
+/** One sparkline point in the overview projection. */
+export declare const SparklinePoint: z.ZodObject<{
+    timestamp: z.ZodNumber;
+    createdAt: z.ZodString;
+    tvl: z.ZodString;
+    sharePrice: z.ZodString;
+}, z.core.$strip>;
+export type SparklinePoint = z.infer<typeof SparklinePoint>;

package/dist/vaults/entities.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { EthereumAddress } from '../common/address';
+
+const VaultStatus = z.enum([
+  "active",
+  "inactive",
+  "pending_activation"
+]);
+const Vault = z.object({
+  id: z.string().uuid(),
+  vaultAddress: EthereumAddress,
+  ownerAddress: EthereumAddress,
+  traderAddress: EthereumAddress.nullable(),
+  agentAddress: EthereumAddress,
+  status: VaultStatus,
+  isApproved: z.boolean(),
+  name: z.string().nullable(),
+  about: z.string().nullable(),
+  imageUrl: z.string().nullable(),
+  transactionHash: z.string().nullable(),
+  maxWithdrawalPeriodDays: z.number().int(),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime()
+});
+const Activity = z.object({
+  id: z.string(),
+  // Absent columns drop off the wire entirely rather than shipping as present nulls.
+  vaultAddress: z.string().optional(),
+  // Mirrors the vault_activity_type Postgres enum; duplicated literally because the SDK cannot import the database package.
+  type: z.enum([
+    "vault.create",
+    "vault.set_trader",
+    "vault.update_metadata",
+    "bridge.withdraw_to_evm"
+  ]),
+  status: z.enum([
+    "pending",
+    "succeeded",
+    "failed"
+  ]),
+  txHash: z.string().optional(),
+  error: z.string().optional(),
+  createdAt: z.iso.datetime(),
+  updatedAt: z.iso.datetime()
+});
+const VaultEvent = z.object({
+  id: z.string(),
+  vaultAddress: EthereumAddress,
+  eventType: z.enum([
+    "DEPOSIT",
+    "WITHDRAWAL"
+  ]),
+  userAddress: EthereumAddress,
+  receiver: EthereumAddress,
+  assets: z.string(),
+  shares: z.string(),
+  fee: z.string(),
+  withdrawalId: z.string().nullable(),
+  txHash: z.string(),
+  blockNumber: z.string(),
+  logIndex: z.number().int(),
+  createdAt: z.string().datetime()
+});
+const NavSnapshot = z.object({
+  vaultAddress: EthereumAddress,
+  takenAt: z.string().datetime(),
+  totalAssets: z.string(),
+  totalSupply: z.string(),
+  sharePrice: z.string(),
+  blockNumber: z.string()
+});
+const NavBucketPoint = z.object({
+  bucket: z.iso.datetime(),
+  totalAssets: z.string(),
+  totalSupply: z.string(),
+  sharePrice: z.string(),
+  blockNumber: z.string()
+});
+const BulkSnapshotPoint = z.object({
+  timestamp: z.number(),
+  createdAt: z.string(),
+  tvl: z.string().optional(),
+  sharePrice: z.string().optional(),
+  accountValue: z.null().optional(),
+  unrealizedPnl: z.null().optional(),
+  cumulativeRealizedPnl: z.null().optional(),
+  leaderSharePct: z.null().optional()
+});
+const SparklinePoint = z.object({
+  timestamp: z.number(),
+  createdAt: z.string(),
+  tvl: z.string(),
+  sharePrice: z.string()
+});
+
+export { Activity, BulkSnapshotPoint, NavBucketPoint, NavSnapshot, SparklinePoint, Vault, VaultEvent, VaultStatus };

package/dist/vaults/index.d.ts

@@ -0,0 +1,4 @@
+export * from './entities';
+export * from './payloads';
+export * from './queries';
+export * from './responses';

package/dist/vaults/index.js

@@ -0,0 +1,4 @@
+export * from './entities';
+export * from './payloads';
+export * from './queries';
+export * from './responses';

package/dist/vaults/payloads.d.ts

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { EthereumAddress } from '../common/address';
+/** Positive decimal amount string, e.g. an withdrawal or approval size. */
+export declare const PositiveAmount: z.ZodString;
+/**
+ * Plane-2 leader-signature envelope carried by every leader-signed POST. LeaderSignatureGuard reads
+ * these fields from the raw body to recover the signer; replay defense is Restate idempotency keyed
+ * on the signature, and the client-minted nonce keeps two legitimate identical actions apart. The envelope carries
+ * auth only; every action-specific parameter is declared on the action's own schema and signed as a
+ * readable field of that action's own EIP-712 struct — the primary-type name discriminates the action.
+ */
+export declare const LeaderSignedAction: z.ZodObject<{
+    signature: z.ZodString;
+    nonce: z.ZodString;
+    deadline: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Create is leader self-signed: the body extends the Plane-2 envelope so
+ * CreateSignatureGuard can recover the signer. Every create field is a readable
+ * field of the signed CreateVault struct.
+ */
+export declare const CreateVault: z.ZodObject<{
+    signature: z.ZodString;
+    nonce: z.ZodString;
+    deadline: z.ZodNumber;
+    leader: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    imageUri: z.ZodOptional<z.ZodURL>;
+    configId: z.ZodNumber;
+    maxWithdrawalPeriodDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type CreateVaultInput = z.input<typeof CreateVault>;
+export type CreateVault = z.infer<typeof CreateVault>;
+/**
+ * Set-trader is leader-signed: the body extends the Plane-2 envelope so
+ * LeaderSignatureGuard can recover the signer and enforce the deadline.
+ * The `traderAddress` is a readable field of the signed SetTrader struct.
+ */
+export declare const SetTrader: z.ZodObject<{
+    signature: z.ZodString;
+    nonce: z.ZodString;
+    deadline: z.ZodNumber;
+    traderAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+}, z.core.$strict>;
+export type SetTraderInput = z.input<typeof SetTrader>;
+export type SetTrader = z.infer<typeof SetTrader>;
+/**
+ * Update-metadata is leader-signed: the body extends the Plane-2 envelope so
+ * LeaderSignatureGuard can recover the signer and enforce the deadline. The
+ * contract is the full display set — every field is sent and signed as a
+ * readable field of the UpdateVaultMetadata struct, because EIP-712 cannot
+ * express an omitted field. An empty string clears the optional columns.
+ */
+export declare const UpdateVaultMetadata: z.ZodObject<{
+    signature: z.ZodString;
+    nonce: z.ZodString;
+    deadline: z.ZodNumber;
+    name: z.ZodString;
+    about: z.ZodString;
+    imageUri: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
+}, z.core.$strict>;
+export type UpdateVaultMetadataInput = z.input<typeof UpdateVaultMetadata>;
+export type UpdateVaultMetadata = z.infer<typeof UpdateVaultMetadata>;
+export declare const WithdrawToEvm: z.ZodObject<{
+    signature: z.ZodString;
+    nonce: z.ZodString;
+    deadline: z.ZodNumber;
+    amount: z.ZodString;
+    tokenId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WithdrawToEvmInput = z.input<typeof WithdrawToEvm>;
+export type WithdrawToEvm = z.infer<typeof WithdrawToEvm>;
+/**
+ * Agent-approve is leader-signed: the body carries only the Plane-2 envelope.
+ * The execution is fixed — maxUint256 on the vault's own asset — so there are no
+ * variable params to sign beyond the envelope; the primary-type name binds the action.
+ */
+export declare const AgentApprove: z.ZodObject<{
+    signature: z.ZodString;
+    nonce: z.ZodString;
+    deadline: z.ZodNumber;
+}, z.core.$strict>;
+export type AgentApproveInput = z.input<typeof AgentApprove>;
+export type AgentApprove = z.infer<typeof AgentApprove>;
+/**
+ * Set-unified-account is leader-signed: the body carries only the Plane-2 envelope.
+ * The execution is fixed — the vault's own agent — so there are no variable
+ * params to sign beyond the envelope; the primary-type name binds the action.
+ */
+export declare const SetUnifiedAccount: z.ZodObject<{
+    signature: z.ZodString;
+    nonce: z.ZodString;
+    deadline: z.ZodNumber;
+}, z.core.$strict>;
+export type SetUnifiedAccountInput = z.input<typeof SetUnifiedAccount>;
+export type SetUnifiedAccount = z.infer<typeof SetUnifiedAccount>;
+/** Builder-fee approval carried by the vault account provisioning workflow. */
+export declare const BuilderFeeApproval: z.ZodObject<{
+    builderAddress: z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>;
+    maxFeeRate: z.ZodCustom<`${string}%`, `${string}%`>;
+}, z.core.$strip>;
+export type BuilderFeeApproval = z.infer<typeof BuilderFeeApproval>;
+export declare const SnapshotsBulk: z.ZodObject<{
+    vaultAddresses: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<EthereumAddress, string>>>;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    bucket: z.ZodEnum<{
+        "1d": "1d";
+        "1m": "1m";
+        "1h": "1h";
+        "5m": "5m";
+        "15m": "15m";
+    }>;
+    fields: z.ZodArray<z.ZodEnum<{
+        unrealizedPnl: "unrealizedPnl";
+        sharePrice: "sharePrice";
+        tvl: "tvl";
+        accountValue: "accountValue";
+        cumulativeRealizedPnl: "cumulativeRealizedPnl";
+        leaderSharePct: "leaderSharePct";
+    }>>;
+}, z.core.$strict>;
+export type SnapshotsBulkInput = z.input<typeof SnapshotsBulk>;
+export type SnapshotsBulk = z.infer<typeof SnapshotsBulk>;
+/**
+ * EIP-712 typed data envelope, in the shape the JSON-RPC `eth_signTypedData_v4`
+ * (and Privy's `signTypedData`) expects. Built inside the service from admitted
+ * actions; never accepted as a caller-supplied signing envelope.
+ */
+export declare const TypedDataPayload: z.ZodObject<{
+    domain: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    types: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>>>;
+    primaryType: z.ZodString;
+    message: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type TypedDataPayload = z.infer<typeof TypedDataPayload>;