@depthhq/sdk 0.1.2 → 0.1.4

package/dist/view/cache.d.ts

@@ -0,0 +1,40 @@
+import type { BalanceSnapshot, PositionSnapshot } from "./view.js";
+type Snapshot = BalanceSnapshot | PositionSnapshot;
+type Kind = "balance" | "market";
+type Envelope = {
+    iv: Uint8Array;
+    data: ArrayBuffer;
+};
+export interface ViewStorage {
+    key(scope: string, proposed: CryptoKey): Promise<CryptoKey>;
+    read(id: string): Promise<Envelope | undefined>;
+    write(id: string, value: Envelope): Promise<void>;
+}
+export declare class DeviceViews implements ViewStorage {
+    private database?;
+    private open;
+    key(scope: string, proposed: CryptoKey): Promise<CryptoKey>;
+    read(id: string): Promise<Envelope | undefined>;
+    write(id: string, value: Envelope): Promise<void>;
+}
+export declare class EncryptedViews {
+    private readonly scope;
+    private readonly storage;
+    private key?;
+    constructor(scope: string, storage: ViewStorage);
+    private encryptionKey;
+    read<T>(name: string): Promise<T | undefined>;
+    write(name: string, value: unknown): Promise<void>;
+}
+export declare class ViewCache {
+    private readonly scope;
+    private readonly storage?;
+    private readonly memory;
+    private key?;
+    constructor(scope: string, storage?: ViewStorage | undefined);
+    private encryptionKey;
+    private id;
+    get<T extends Snapshot>(kind: Kind, account: string, version: bigint): Promise<T | undefined>;
+    set(kind: Kind, account: string, snapshot: Snapshot): Promise<void>;
+}
+export {};

package/dist/view/session.d.ts

@@ -0,0 +1,28 @@
+import * as anchor from "@anchor-lang/core";
+import { type ViewKind } from "@depthhq/schema";
+import { PublicKey, type Connection } from "@solana/web3.js";
+import { type ViewStorage } from "./cache.js";
+import { DepthView } from "./view.js";
+export declare class ViewSession {
+    private readonly program;
+    private readonly connection;
+    private readonly owner;
+    private readonly serviceUrl;
+    private readonly scope;
+    private readonly storage?;
+    private readonly pending;
+    constructor(program: anchor.Program, connection: Connection, owner: PublicKey, serviceUrl: string | undefined, scope: string, storage?: ViewStorage);
+    private identity;
+    private keys;
+    status(): Promise<{
+        active: boolean;
+        expiresAt?: number;
+        id: string;
+    }>;
+    private capability;
+    authorize(): Promise<void>;
+    revoke(): Promise<string>;
+    private post;
+    request(kind: ViewKind, source: PublicKey): Promise<DepthView>;
+    private read;
+}

package/dist/view/view.d.ts

@@ -4,6 +4,7 @@ export type BalanceSnapshot = {
     status: "uninitialized" | "pending" | "ready" | "stale";
     id: string;
     version: bigint;
+    readAt?: number;
     slot: number;
     amount?: bigint;
 };
@@ -11,6 +12,7 @@ export type PositionSnapshot = {
     status: "pending" | "ready" | "stale";
     id: string;
     version: bigint;
+    readAt?: number;
     slot: number;
     collateral?: bigint;
     reserved?: bigint;
@@ -49,11 +51,15 @@ export declare class DepthView {
     private readonly mxePublicKey;
     private readonly program;
     private readonly connection;
-    constructor(id: PublicKey, signature: string, kind: "balance" | "market" | "fill" | "quote", owner: PublicKey, secret: Uint8Array, publicKey: Uint8Array, mxePublicKey: Uint8Array, program: anchor.Program, connection: Connection);
+    private readonly source?;
+    private readonly release?;
+    constructor(id: PublicKey, signature: string, kind: "balance" | "market" | "fill" | "quote", owner: PublicKey, secret: Uint8Array, publicKey: Uint8Array, mxePublicKey: Uint8Array, program: anchor.Program, connection: Connection, source?: PublicKey | undefined, release?: (() => Promise<string>) | undefined);
     status(): Promise<BalanceSnapshot | PositionSnapshot | FillSnapshot | QuoteBalanceSnapshot>;
     wait(options: {
         timeoutMs: number;
         pollMs?: number;
     }): Promise<BalanceSnapshot | PositionSnapshot | FillSnapshot | QuoteBalanceSnapshot>;
+    deferClose(): Promise<void>;
+    private closeBuilder;
     close(): Promise<string>;
 }

package/dist/view/view.js

@@ -26583,7 +26583,9 @@ class DepthView {
   mxePublicKey;
   program;
   connection;
-  constructor(id, signature, kind, owner, secret, publicKey, mxePublicKey, program, connection) {
+  source;
+  release;
+  constructor(id, signature, kind, owner, secret, publicKey, mxePublicKey, program, connection, source, release) {
     this.id = id;
     this.signature = signature;
     this.kind = kind;
@@ -26593,6 +26595,8 @@ class DepthView {
     this.mxePublicKey = mxePublicKey;
     this.program = program;
     this.connection = connection;
+    this.source = source;
+    this.release = release;
   }
   async status() {
     const response = await this.connection.getAccountInfoAndContext(this.id, "confirmed");
@@ -26603,6 +26607,9 @@ class DepthView {
     if (!state.owner.equals(this.owner) || !Buffer.from(state.viewKey).equals(Buffer.from(this.publicKey))) {
       throw new Error("Private view authorization does not match this request");
     }
+    const source = this.kind === "balance" ? state.balance : this.kind === "market" ? state.marketAccount : this.kind === "fill" ? state.order : state.quote;
+    if (this.source && !source?.equals(this.source))
+      throw new Error("Private view source does not match this request");
     const current = Object.keys(state.status)[0];
     if (current !== "pending" && current !== "ready" && current !== "stale") {
       throw new Error("Private view has an unknown status");
@@ -26667,13 +26674,34 @@ class DepthView {
       await new Promise((resolve) => setTimeout(resolve, Math.min(pollMs, deadline - Date.now())));
     }
   }
+  async deferClose() {
+    if (this.release) {
+      await this.close();
+      return;
+    }
+    const provider = this.program.provider;
+    if (typeof provider.deferClose !== "function") {
+      await this.close();
+      return;
+    }
+    const snapshot = await this.status();
+    if (snapshot.status === "pending")
+      throw new Error("Private view computation is still pending");
+    const instruction = await this.closeBuilder().instruction();
+    provider.deferClose(this.id, instruction);
+  }
+  closeBuilder() {
+    const builder = this.kind === "balance" ? this.program.methods.closeBalanceView() : this.kind === "market" ? this.program.methods.closeMarketView() : this.kind === "fill" ? this.program.methods.closeFillView() : this.program.methods.closeQuoteView();
+    return builder.accountsPartial({ owner: this.owner, view: this.id });
+  }
   async close() {
     const snapshot = await this.status();
     if (snapshot.status === "pending") {
       throw new Error("Private view computation is still pending");
     }
-    const builder = this.kind === "balance" ? this.program.methods.closeBalanceView() : this.kind === "market" ? this.program.methods.closeMarketView() : this.kind === "fill" ? this.program.methods.closeFillView() : this.program.methods.closeQuoteView();
-    return builder.accountsPartial({ owner: this.owner, view: this.id }).rpc({ commitment: "confirmed" });
+    if (this.release)
+      return this.release();
+    return this.closeBuilder().rpc({ commitment: "confirmed" });
   }
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@depthhq/sdk",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "publishConfig": {
     "access": "public"
   },
@@ -44,8 +44,11 @@
     "@noble/hashes": "1.8.0",
     "@solana/web3.js": "1.99.0",
     "buffer": "6.0.3",
-    "@depthhq/bindings": "0.1.1",
-    "@depthhq/schema": "0.1.1"
+    "@depthhq/bindings": "0.1.2",
+    "@depthhq/schema": "0.1.2"
+  },
+  "devDependencies": {
+    "fake-indexeddb": "6.2.4"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs sdk",