@opendatalabs/vana-sdk 3.21.0 → 3.22.0-pr.207.e47cd30

package/dist/protocol/identity.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Enclave identity and consent primitives for Personal Servers.
+ *
+ * Owner/Web -> Gateway -> Agent(CVM): derive wallet and quote
+ * Web verifies evidence; Account encrypts the EIP-191 master signature to the
+ * enclave public key; Gateway relays it blind; Agent decrypts and seals it.
+ *
+ * @category Protocol
+ */
+import { type Address, type Hex } from "viem";
+import { type ECIESProvider } from "../crypto/ecies/interface.js";
+import type { ServerRegistrationMessage } from "./eip712.js";
+export declare const ENCLAVE_IDENTITY_EVIDENCE_VERSION = 1;
+export declare const USER_PS_ID_DOMAIN = "vana.ps-enclave.v1";
+export declare const ENCLAVE_WALLET_PURPOSE = "vana.ps-enclave.wallet.v1";
+export declare const MASTER_SIGNATURE_DELIVERY_VERSION = "vana.ps-enclave.delivery.v1";
+export declare const SEALED_ENVELOPE_VERSION = 1;
+export type UserPsId = Hex;
+export interface EnclaveIdentityEvidence {
+    v: typeof ENCLAVE_IDENTITY_EVIDENCE_VERSION;
+    userPsId: UserPsId;
+    chainId: number;
+    ownerAddress: Address;
+    epoch: number;
+    address: Address;
+    publicKey: Hex;
+    appId: Hex;
+    composeHash: Hex;
+    osImageHash?: Hex;
+    purpose: string;
+    signatureChain: [Hex, Hex];
+    quote: Hex;
+    eventLog?: string;
+    kmsRootFingerprint: Hex;
+}
+export interface IdentityRequest {
+    ownerAddress: Address;
+    chainId: number;
+}
+export type IdentityState = "prepared" | "registered" | "sealed" | "retired";
+export interface IdentityResponse {
+    identity: EnclaveIdentityEvidence;
+    state: IdentityState;
+    created: boolean;
+    serverUrl: string;
+    serverId?: Hex;
+    serverStatus?: "pending" | "submitting" | "confirmed" | "finalized" | "failed";
+    sealed: boolean;
+}
+export type IdentityRegistrationRequest = {
+    version: "v2";
+    message: ServerRegistrationMessage;
+} | {
+    version: "v3";
+    message: ServerRegistrationMessage & {
+        nonce: string;
+        deadline: string;
+    };
+};
+export interface IdentityRegistrationResponse {
+    serverId: Hex;
+    state: "registered";
+    serverStatus: "pending";
+}
+/** Inner plaintext of the ECIES box. */
+export interface MasterSignatureDelivery {
+    v: typeof MASTER_SIGNATURE_DELIVERY_VERSION;
+    userPsId: UserPsId;
+    epoch: number;
+    enclaveAddress: Address;
+    ownerAddress: Address;
+    masterSignature: Hex;
+    issuedAt: number;
+}
+export interface SealedSecretSubmission {
+    userPsId: UserPsId;
+    epoch: number;
+    enclaveAddress: Address;
+    ciphertext: Hex;
+}
+export interface SealedSecretResponse {
+    sealed: true;
+    secretHash: Hex;
+    sealedAt: string;
+}
+export interface AesGcmBox {
+    iv: string;
+    ciphertext: string;
+    tag: string;
+}
+/** Persisted enclave envelope; the Gateway treats it as opaque text. */
+export interface SealedEnvelope extends AesGcmBox {
+    v: typeof SEALED_ENVELOPE_VERSION;
+    wrappedContentKey: AesGcmBox;
+}
+export interface EnclaveTrustAnchors {
+    kmsRootPubkey: Hex;
+    appIds: Hex[];
+}
+/** Fleet-provisioned trust anchors keyed by Vana chain ID. */
+export declare const ENCLAVE_TRUST_ANCHORS: Record<number, EnclaveTrustAnchors>;
+/**
+ * Derives the deterministic Personal Server ID used by enclave paths.
+ *
+ * @param chainId - Vana chain ID.
+ * @param ownerAddress - Checksummed owner address.
+ * @returns The path-compatible keccak256 digest.
+ */
+export declare function userPsId(chainId: number, ownerAddress: Address): UserPsId;
+/**
+ * Builds keccak256(purpose || ":" || hex(pubkey)) for signature-chain link 0.
+ *
+ * ASSUMPTION: hex(pubkey) is lowercase, without 0x, for the 65-byte key.
+ * TODO(verify-against-dstack-vector): pin with a captured CVM chain
+ * (dstack kms/src/crypto.rs).
+ */
+export declare function appRootPreimage(purpose: string, publicKey: Hex): Hex;
+/**
+ * Builds the dstack KMS issuance digest for signature-chain link 1.
+ *
+ * ASSUMPTION: appId is lowercase hex without 0x encoded as UTF-8; the app-root
+ * key is appended as 33 raw SEC1-compressed bytes.
+ * TODO(verify-against-dstack-vector): pin with a captured CVM chain.
+ */
+export declare function kmsIssuedPreimage(appId: Hex, appRootPublicKey: Hex): Hex;
+/**
+ * Verifies the enclave wallet binding against fleet-provisioned trust anchors.
+ *
+ * @param evidence - Identity evidence returned by the enclave agent.
+ * @param anchors - Pinned KMS root and allowed dstack app IDs.
+ * @throws When any identity binding or trust check fails.
+ */
+export declare function verifyEnclaveIdentityEvidence(evidence: EnclaveIdentityEvidence, anchors: EnclaveTrustAnchors): Promise<void>;
+/**
+ * Builds the authenticated master-signature plaintext delivered to an enclave.
+ *
+ * @param evidence - Verified enclave identity evidence.
+ * @param masterSignature - EIP-191 signature over the master-key message.
+ * @param now - Issuance time in Unix seconds.
+ * @returns The plaintext delivery object.
+ */
+export declare function buildMasterSignatureDelivery(evidence: EnclaveIdentityEvidence, masterSignature: Hex, now?: number): MasterSignatureDelivery;
+/**
+ * Encrypts a master-signature delivery in the SDK's ECIES wire format.
+ *
+ * @param delivery - Plaintext delivery object.
+ * @param publicKey - Enclave 65-byte uncompressed public key.
+ * @param ecies - Platform-specific ECIES provider.
+ * @returns The 0x-prefixed serialized ciphertext.
+ */
+export declare function encryptMasterSignatureDelivery(delivery: MasterSignatureDelivery, publicKey: Hex, ecies: ECIESProvider): Promise<Hex>;

package/dist/protocol/identity.js

@@ -0,0 +1,132 @@
+import * as secp256k1 from "@noble/secp256k1";
+import {
+  concat,
+  encodePacked,
+  fromHex,
+  getAddress,
+  keccak256,
+  recoverPublicKey,
+  toBytes
+} from "viem";
+import { publicKeyToAddress } from "viem/accounts";
+import { serializeECIES } from "../crypto/ecies/interface.js";
+import { deriveMasterKey } from "../crypto/keys/derive.js";
+const ENCLAVE_IDENTITY_EVIDENCE_VERSION = 1;
+const USER_PS_ID_DOMAIN = "vana.ps-enclave.v1";
+const ENCLAVE_WALLET_PURPOSE = "vana.ps-enclave.wallet.v1";
+const MASTER_SIGNATURE_DELIVERY_VERSION = "vana.ps-enclave.delivery.v1";
+const SEALED_ENVELOPE_VERSION = 1;
+const VANA_MAINNET_CHAIN_ID = 1480;
+const MOKSHA_CHAIN_ID = 14800;
+const KMS_ISSUED_PREFIX = "dstack-kms-issued";
+const PREIMAGE_SEPARATOR = ":";
+const UNCOMPRESSED_PUBLIC_KEY_BYTES = 65;
+const UNCOMPRESSED_PUBLIC_KEY_PREFIX = "04";
+const ENCLAVE_TRUST_ANCHORS = {
+  // filled at fleet provisioning; verify fails closed while empty
+  [VANA_MAINNET_CHAIN_ID]: { kmsRootPubkey: "0x", appIds: [] },
+  // filled at fleet provisioning; verify fails closed while empty
+  [MOKSHA_CHAIN_ID]: { kmsRootPubkey: "0x", appIds: [] }
+};
+function userPsId(chainId, ownerAddress) {
+  const packed = encodePacked(
+    ["string", "uint256", "address"],
+    [USER_PS_ID_DOMAIN, BigInt(chainId), getAddress(ownerAddress)]
+  );
+  return keccak256(packed);
+}
+function appRootPreimage(purpose, publicKey) {
+  const keyHex = publicKey.slice(2).toLowerCase();
+  return keccak256(toBytes(`${purpose}${PREIMAGE_SEPARATOR}${keyHex}`));
+}
+function kmsIssuedPreimage(appId, appRootPublicKey) {
+  const appIdHex = appId.slice(2).toLowerCase();
+  const prefix = toBytes(
+    `${KMS_ISSUED_PREFIX}${PREIMAGE_SEPARATOR}${appIdHex}`
+  );
+  const compressed = secp256k1.ProjectivePoint.fromHex(
+    fromHex(appRootPublicKey, "bytes")
+  ).toRawBytes(true);
+  return keccak256(concat([prefix, compressed]));
+}
+async function recoverChainKey(hash, signature, link) {
+  try {
+    return (await recoverPublicKey({ hash, signature })).toLowerCase();
+  } catch {
+    throw new Error(`Invalid enclave signature chain link ${link}`);
+  }
+}
+async function verifyEnclaveIdentityEvidence(evidence, anchors) {
+  if (evidence.v !== ENCLAVE_IDENTITY_EVIDENCE_VERSION) {
+    throw new Error("Unsupported enclave identity evidence version");
+  }
+  if (!Number.isInteger(evidence.epoch) || evidence.epoch < 1) {
+    throw new Error("Invalid enclave identity epoch");
+  }
+  const derivedAddress = publicKeyToAddress(evidence.publicKey);
+  if (getAddress(derivedAddress) !== getAddress(evidence.address)) {
+    throw new Error("Enclave public key does not match its address");
+  }
+  const appRootPublicKey = await recoverChainKey(
+    appRootPreimage(evidence.purpose, evidence.publicKey),
+    evidence.signatureChain[0],
+    0
+  );
+  const kmsRootPublicKey = await recoverChainKey(
+    kmsIssuedPreimage(evidence.appId, appRootPublicKey),
+    evidence.signatureChain[1],
+    1
+  );
+  if (anchors.kmsRootPubkey === "0x") {
+    throw new Error("KMS root trust anchor is not provisioned");
+  }
+  if (kmsRootPublicKey !== anchors.kmsRootPubkey.toLowerCase()) {
+    throw new Error("KMS root public key does not match the trust anchor");
+  }
+  if (keccak256(kmsRootPublicKey) !== evidence.kmsRootFingerprint.toLowerCase()) {
+    throw new Error("KMS root fingerprint does not match the evidence");
+  }
+  const appId = evidence.appId.toLowerCase();
+  if (!anchors.appIds.some((allowedAppId) => allowedAppId.toLowerCase() === appId)) {
+    throw new Error("Enclave app ID is not trusted");
+  }
+}
+function buildMasterSignatureDelivery(evidence, masterSignature, now = Math.floor(Date.now() / 1e3)) {
+  deriveMasterKey(masterSignature);
+  return {
+    v: MASTER_SIGNATURE_DELIVERY_VERSION,
+    userPsId: evidence.userPsId,
+    epoch: evidence.epoch,
+    enclaveAddress: evidence.address,
+    ownerAddress: evidence.ownerAddress,
+    masterSignature,
+    issuedAt: now
+  };
+}
+function assertUncompressedKey(publicKey) {
+  const hex = publicKey.slice(2);
+  if (hex.length !== UNCOMPRESSED_PUBLIC_KEY_BYTES * 2 || !hex.startsWith(UNCOMPRESSED_PUBLIC_KEY_PREFIX) || !/^[0-9a-fA-F]+$/.test(hex)) {
+    throw new Error("Public key must be a 65-byte uncompressed secp256k1 key");
+  }
+}
+async function encryptMasterSignatureDelivery(delivery, publicKey, ecies) {
+  assertUncompressedKey(publicKey);
+  const plaintext = toBytes(JSON.stringify(delivery));
+  const encrypted = await ecies.encrypt(fromHex(publicKey, "bytes"), plaintext);
+  return `0x${serializeECIES(encrypted)}`;
+}
+export {
+  ENCLAVE_IDENTITY_EVIDENCE_VERSION,
+  ENCLAVE_TRUST_ANCHORS,
+  ENCLAVE_WALLET_PURPOSE,
+  MASTER_SIGNATURE_DELIVERY_VERSION,
+  SEALED_ENVELOPE_VERSION,
+  USER_PS_ID_DOMAIN,
+  appRootPreimage,
+  buildMasterSignatureDelivery,
+  encryptMasterSignatureDelivery,
+  kmsIssuedPreimage,
+  userPsId,
+  verifyEnclaveIdentityEvidence
+};
+//# sourceMappingURL=identity.js.map

package/dist/protocol/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/identity.ts"],"sourcesContent":["/**\n * Enclave identity and consent primitives for Personal Servers.\n *\n * Owner/Web -> Gateway -> Agent(CVM): derive wallet and quote\n * Web verifies evidence; Account encrypts the EIP-191 master signature to the\n * enclave public key; Gateway relays it blind; Agent decrypts and seals it.\n *\n * @category Protocol\n */\n\nimport * as secp256k1 from \"@noble/secp256k1\";\nimport {\n  concat,\n  encodePacked,\n  fromHex,\n  getAddress,\n  keccak256,\n  recoverPublicKey,\n  toBytes,\n  type Address,\n  type Hex,\n} from \"viem\";\nimport { publicKeyToAddress } from \"viem/accounts\";\nimport { serializeECIES, type ECIESProvider } from \"../crypto/ecies/interface\";\nimport { deriveMasterKey } from \"../crypto/keys/derive\";\nimport type { ServerRegistrationMessage } from \"./eip712\";\n\nexport const ENCLAVE_IDENTITY_EVIDENCE_VERSION = 1;\nexport const USER_PS_ID_DOMAIN = \"vana.ps-enclave.v1\";\nexport const ENCLAVE_WALLET_PURPOSE = \"vana.ps-enclave.wallet.v1\";\nexport const MASTER_SIGNATURE_DELIVERY_VERSION = \"vana.ps-enclave.delivery.v1\";\nexport const SEALED_ENVELOPE_VERSION = 1;\n\nconst VANA_MAINNET_CHAIN_ID = 1480;\nconst MOKSHA_CHAIN_ID = 14800;\nconst KMS_ISSUED_PREFIX = \"dstack-kms-issued\";\nconst PREIMAGE_SEPARATOR = \":\";\nconst UNCOMPRESSED_PUBLIC_KEY_BYTES = 65;\nconst UNCOMPRESSED_PUBLIC_KEY_PREFIX = \"04\";\n\nexport type UserPsId = Hex;\n\nexport interface EnclaveIdentityEvidence {\n  v: typeof ENCLAVE_IDENTITY_EVIDENCE_VERSION;\n  userPsId: UserPsId;\n  chainId: number;\n  ownerAddress: Address;\n  epoch: number;\n  address: Address;\n  publicKey: Hex;\n  appId: Hex;\n  composeHash: Hex;\n  osImageHash?: Hex;\n  purpose: string;\n  signatureChain: [Hex, Hex];\n  quote: Hex;\n  eventLog?: string;\n  kmsRootFingerprint: Hex;\n}\n\nexport interface IdentityRequest {\n  ownerAddress: Address;\n  chainId: number;\n}\n\nexport type IdentityState = \"prepared\" | \"registered\" | \"sealed\" | \"retired\";\n\nexport interface IdentityResponse {\n  identity: EnclaveIdentityEvidence;\n  state: IdentityState;\n  created: boolean;\n  serverUrl: string;\n  serverId?: Hex;\n  serverStatus?:\n    | \"pending\"\n    | \"submitting\"\n    | \"confirmed\"\n    | \"finalized\"\n    | \"failed\";\n  sealed: boolean;\n}\n\nexport type IdentityRegistrationRequest =\n  | { version: \"v2\"; message: ServerRegistrationMessage }\n  | {\n      version: \"v3\";\n      message: ServerRegistrationMessage & { nonce: string; deadline: string };\n    };\n\nexport interface IdentityRegistrationResponse {\n  serverId: Hex;\n  state: \"registered\";\n  serverStatus: \"pending\";\n}\n\n/** Inner plaintext of the ECIES box. */\nexport interface MasterSignatureDelivery {\n  v: typeof MASTER_SIGNATURE_DELIVERY_VERSION;\n  userPsId: UserPsId;\n  epoch: number;\n  enclaveAddress: Address;\n  ownerAddress: Address;\n  masterSignature: Hex;\n  issuedAt: number;\n}\n\nexport interface SealedSecretSubmission {\n  userPsId: UserPsId;\n  epoch: number;\n  enclaveAddress: Address;\n  ciphertext: Hex;\n}\n\nexport interface SealedSecretResponse {\n  sealed: true;\n  secretHash: Hex;\n  sealedAt: string;\n}\n\nexport interface AesGcmBox {\n  iv: string;\n  ciphertext: string;\n  tag: string;\n}\n\n/** Persisted enclave envelope; the Gateway treats it as opaque text. */\nexport interface SealedEnvelope extends AesGcmBox {\n  v: typeof SEALED_ENVELOPE_VERSION;\n  wrappedContentKey: AesGcmBox;\n}\n\nexport interface EnclaveTrustAnchors {\n  kmsRootPubkey: Hex;\n  appIds: Hex[];\n}\n\n/** Fleet-provisioned trust anchors keyed by Vana chain ID. */\nexport const ENCLAVE_TRUST_ANCHORS: Record<number, EnclaveTrustAnchors> = {\n  // filled at fleet provisioning; verify fails closed while empty\n  [VANA_MAINNET_CHAIN_ID]: { kmsRootPubkey: \"0x\", appIds: [] },\n  // filled at fleet provisioning; verify fails closed while empty\n  [MOKSHA_CHAIN_ID]: { kmsRootPubkey: \"0x\", appIds: [] },\n};\n\n/**\n * Derives the deterministic Personal Server ID used by enclave paths.\n *\n * @param chainId - Vana chain ID.\n * @param ownerAddress - Checksummed owner address.\n * @returns The path-compatible keccak256 digest.\n */\nexport function userPsId(chainId: number, ownerAddress: Address): UserPsId {\n  const packed = encodePacked(\n    [\"string\", \"uint256\", \"address\"],\n    [USER_PS_ID_DOMAIN, BigInt(chainId), getAddress(ownerAddress)],\n  );\n\n  return keccak256(packed);\n}\n\n/**\n * Builds keccak256(purpose || \":\" || hex(pubkey)) for signature-chain link 0.\n *\n * ASSUMPTION: hex(pubkey) is lowercase, without 0x, for the 65-byte key.\n * TODO(verify-against-dstack-vector): pin with a captured CVM chain\n * (dstack kms/src/crypto.rs).\n */\nexport function appRootPreimage(purpose: string, publicKey: Hex): Hex {\n  const keyHex = publicKey.slice(2).toLowerCase();\n  return keccak256(toBytes(`${purpose}${PREIMAGE_SEPARATOR}${keyHex}`));\n}\n\n/**\n * Builds the dstack KMS issuance digest for signature-chain link 1.\n *\n * ASSUMPTION: appId is lowercase hex without 0x encoded as UTF-8; the app-root\n * key is appended as 33 raw SEC1-compressed bytes.\n * TODO(verify-against-dstack-vector): pin with a captured CVM chain.\n */\nexport function kmsIssuedPreimage(appId: Hex, appRootPublicKey: Hex): Hex {\n  const appIdHex = appId.slice(2).toLowerCase();\n  const prefix = toBytes(\n    `${KMS_ISSUED_PREFIX}${PREIMAGE_SEPARATOR}${appIdHex}`,\n  );\n  const compressed = secp256k1.ProjectivePoint.fromHex(\n    fromHex(appRootPublicKey, \"bytes\"),\n  ).toRawBytes(true);\n\n  return keccak256(concat([prefix, compressed]));\n}\n\nasync function recoverChainKey(\n  hash: Hex,\n  signature: Hex,\n  link: number,\n): Promise<Hex> {\n  try {\n    return (await recoverPublicKey({ hash, signature })).toLowerCase() as Hex;\n  } catch {\n    throw new Error(`Invalid enclave signature chain link ${link}`);\n  }\n}\n\n/**\n * Verifies the enclave wallet binding against fleet-provisioned trust anchors.\n *\n * @param evidence - Identity evidence returned by the enclave agent.\n * @param anchors - Pinned KMS root and allowed dstack app IDs.\n * @throws When any identity binding or trust check fails.\n */\nexport async function verifyEnclaveIdentityEvidence(\n  evidence: EnclaveIdentityEvidence,\n  anchors: EnclaveTrustAnchors,\n): Promise<void> {\n  if (evidence.v !== ENCLAVE_IDENTITY_EVIDENCE_VERSION) {\n    throw new Error(\"Unsupported enclave identity evidence version\");\n  }\n\n  if (!Number.isInteger(evidence.epoch) || evidence.epoch < 1) {\n    throw new Error(\"Invalid enclave identity epoch\");\n  }\n\n  const derivedAddress = publicKeyToAddress(evidence.publicKey);\n\n  if (getAddress(derivedAddress) !== getAddress(evidence.address)) {\n    throw new Error(\"Enclave public key does not match its address\");\n  }\n\n  const appRootPublicKey = await recoverChainKey(\n    appRootPreimage(evidence.purpose, evidence.publicKey),\n    evidence.signatureChain[0],\n    0,\n  );\n  const kmsRootPublicKey = await recoverChainKey(\n    kmsIssuedPreimage(evidence.appId, appRootPublicKey),\n    evidence.signatureChain[1],\n    1,\n  );\n\n  if (anchors.kmsRootPubkey === \"0x\") {\n    throw new Error(\"KMS root trust anchor is not provisioned\");\n  }\n\n  if (kmsRootPublicKey !== anchors.kmsRootPubkey.toLowerCase()) {\n    throw new Error(\"KMS root public key does not match the trust anchor\");\n  }\n\n  if (\n    keccak256(kmsRootPublicKey) !== evidence.kmsRootFingerprint.toLowerCase()\n  ) {\n    throw new Error(\"KMS root fingerprint does not match the evidence\");\n  }\n\n  const appId = evidence.appId.toLowerCase();\n  if (\n    !anchors.appIds.some((allowedAppId) => allowedAppId.toLowerCase() === appId)\n  ) {\n    throw new Error(\"Enclave app ID is not trusted\");\n  }\n}\n\n/**\n * Builds the authenticated master-signature plaintext delivered to an enclave.\n *\n * @param evidence - Verified enclave identity evidence.\n * @param masterSignature - EIP-191 signature over the master-key message.\n * @param now - Issuance time in Unix seconds.\n * @returns The plaintext delivery object.\n */\nexport function buildMasterSignatureDelivery(\n  evidence: EnclaveIdentityEvidence,\n  masterSignature: Hex,\n  now = Math.floor(Date.now() / 1000),\n): MasterSignatureDelivery {\n  deriveMasterKey(masterSignature);\n\n  return {\n    v: MASTER_SIGNATURE_DELIVERY_VERSION,\n    userPsId: evidence.userPsId,\n    epoch: evidence.epoch,\n    enclaveAddress: evidence.address,\n    ownerAddress: evidence.ownerAddress,\n    masterSignature,\n    issuedAt: now,\n  };\n}\n\nfunction assertUncompressedKey(publicKey: Hex): void {\n  const hex = publicKey.slice(2);\n  if (\n    hex.length !== UNCOMPRESSED_PUBLIC_KEY_BYTES * 2 ||\n    !hex.startsWith(UNCOMPRESSED_PUBLIC_KEY_PREFIX) ||\n    !/^[0-9a-fA-F]+$/.test(hex)\n  ) {\n    throw new Error(\"Public key must be a 65-byte uncompressed secp256k1 key\");\n  }\n}\n\n/**\n * Encrypts a master-signature delivery in the SDK's ECIES wire format.\n *\n * @param delivery - Plaintext delivery object.\n * @param publicKey - Enclave 65-byte uncompressed public key.\n * @param ecies - Platform-specific ECIES provider.\n * @returns The 0x-prefixed serialized ciphertext.\n */\nexport async function encryptMasterSignatureDelivery(\n  delivery: MasterSignatureDelivery,\n  publicKey: Hex,\n  ecies: ECIESProvider,\n): Promise<Hex> {\n  assertUncompressedKey(publicKey);\n\n  const plaintext = toBytes(JSON.stringify(delivery));\n  const encrypted = await ecies.encrypt(fromHex(publicKey, \"bytes\"), plaintext);\n\n  return `0x${serializeECIES(encrypted)}`;\n}\n"],"mappings":"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","names":[]}

package/dist/protocol/identity.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/mock-personal-server.d.ts

@@ -84,6 +84,13 @@ export interface MockQuestion {
     };
     status: "pending" | "ready" | "failed" | "stale";
     error: string | null;
+    /** The coarse failure class the status route serves; null unless failed. */
+    errorCode: "inference_unavailable" | "source_missing" | "grant_invalid" | "internal" | null;
+    /**
+     * What the status route reports as the next automatic retry. The mock has
+     * no scheduler, so a test sets it through `settleQuestion`.
+     */
+    retryAfterSeconds: number | null;
     createdAt: string;
     updatedAt: string;
     lastComputedAt: string | null;
@@ -126,6 +133,8 @@ export interface MockPersonalServer {
     } | {
         status: "failed";
         error: string;
+        errorCode?: MockQuestion["errorCode"];
+        retryAfterSeconds?: number | null;
     } | {
         status: "stale" | "pending";
     }): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendatalabs/vana-sdk",
-  "version": "3.21.0",
+  "version": "3.22.0-pr.207.e47cd30",
   "description": "A TypeScript library for interacting with Vana Network smart contracts.",
   "publishConfig": {
     "access": "public"