@opendatalabs/vana-sdk 3.4.1 → 3.5.1

package/dist/index.node.d.ts

@@ -37,11 +37,12 @@ export { InMemoryTokenStore, type TokenStore, type TokenRecord, } from "./auth/t
 export { OAuthClient, type OAuthClientConfig, type AuthorizationUrlResult, } from "./auth/oauth-client";
 export { fileRegistrationDomain, fileDeletionDomain, grantRegistrationDomain, grantRevocationDomain, serverRegistrationDomain, builderRegistrationDomain, FILE_REGISTRATION_TYPES, FILE_DELETION_TYPES, GRANT_REGISTRATION_TYPES, GRANT_REVOCATION_TYPES, SERVER_REGISTRATION_TYPES, BUILDER_REGISTRATION_TYPES, type DataPortabilityContracts, type DataPortabilityGatewayConfig, type FileRegistrationMessage, type FileDeletionMessage, type GrantRegistrationMessage, type GrantRevocationMessage, type ServerRegistrationMessage, type BuilderRegistrationMessage, } from "./protocol/eip712";
 export { PERSONAL_SERVER_REGISTRATION_DEFAULT_CHAIN_ID, PERSONAL_SERVER_REGISTRATION_DEFAULT_VERIFYING_CONTRACT, personalServerRegistrationDomain, createViemPersonalServerRegistrationSigner, buildPersonalServerRegistrationTypedData, buildPersonalServerRegistrationSignature, registerPersonalServerSignature, type PersonalServerRegistrationTypedData, type PersonalServerRegistrationSigner, type PersonalServerRegistrationDomainInput, type ViemPersonalServerRegistrationWalletClient, type ViemPersonalServerRegistrationSignerSource, type BuildPersonalServerRegistrationTypedDataInput, type BuildPersonalServerRegistrationSignatureInput, type PersonalServerRegistrationSignature, } from "./protocol/personal-server-registration";
-export { PERSONAL_SERVER_LITE_OWNER_BINDING_VERSION, PERSONAL_SERVER_LITE_OWNER_BINDING_PURPOSE, PERSONAL_SERVER_LITE_OWNER_BINDING_PREFIX, buildPersonalServerLiteOwnerBindingMessage, createViemPersonalServerLiteOwnerBindingSigner, buildPersonalServerLiteOwnerBindingSignature, signPersonalServerLiteOwnerBinding, type PersonalServerLiteOwnerBindingPurpose, type PersonalServerLiteOwnerBindingMessage, type PersonalServerLiteOwnerBindingSigner, type ViemPersonalServerLiteOwnerBindingWalletClient, type ViemPersonalServerLiteOwnerBindingSignerSource, type BuildPersonalServerLiteOwnerBindingSignatureInput, type PersonalServerLiteOwnerBindingSignature, } from "./protocol/personal-server-lite-owner-binding";
+export { PERSONAL_SERVER_LITE_OWNER_BINDING_VERSION, PERSONAL_SERVER_LITE_OWNER_BINDING_PURPOSE, PERSONAL_SERVER_LITE_OWNER_BINDING_PREFIX, buildPersonalServerLiteOwnerBindingMessage, createViemPersonalServerLiteOwnerBindingSigner, buildPersonalServerLiteOwnerBindingSignature, signPersonalServerLiteOwnerBinding, type PersonalServerLiteOwnerBindingPurpose, type PersonalServerLiteOwnerBindingMessage, type PersonalServerLiteOwnerBindingSigner, type ViemPersonalServerLiteOwnerBindingWalletClient, type ViemPersonalServerLiteOwnerBindingSignerSource, type BuildPersonalServerLiteOwnerBindingSignatureInput, type PersonalServerLiteOwnerBindingSignature, } from "./personal-server-lite/owner-binding";
 export { ACCOUNT_PERSONAL_SERVER_REGISTRATION_INTENT, AccountPersonalServerRegistrationError, signPersonalServerRegistrationWithAccount, type AccountPersonalServerRegistrationIntent, type AccountPersonalServerRegistrationSignature, type AccountPersonalServerRegistrationStatus, type AccountPersonalServerRegistrationRequest, type AccountPersonalServerRegistrationConfig, type AccountSignedPersonalServerRegistration, type AccountConfirmationRequiredPersonalServerRegistration, type AccountFallbackSignedPersonalServerRegistration, type AccountPersonalServerRegistrationResult, } from "./account/personal-server-registration";
 export { AccountPersonalServerLiteOwnerBindingError, signPersonalServerLiteOwnerBindingWithAccountClient, type AccountPersonalServerLiteOwnerBindingClient, type SignPersonalServerLiteOwnerBindingWithAccountClientConfig, } from "./account/personal-server-lite-owner-binding";
 export { isDataPortabilityGatewayConfig, parseGrantRegistrationPayload, verifyGrantRegistration, type DataPortabilityGrantPayload, type VerifyGrantRegistrationInput, type VerifyGrantRegistrationResult, } from "./protocol/grants";
 export { ScopeSchema, parseScope, scopeToPathSegments, scopeMatchesPattern, scopeCoveredByGrant, type Scope, type ParsedScope, } from "./protocol/scopes";
 export { DataFileEnvelopeSchema, createDataFileEnvelope, IngestResponseSchema, type DataFileEnvelope, type IngestResponse, } from "./protocol/data-file";
 export { createGatewayClient, type GatewayEnvelope, type GatewayProof, type Builder, type Schema, type ServerInfo, type GatewayGrantResponse, type GrantListItem, type FileRecord, type FileListResult, type ListFilesOptions, type RegisterServerParams, type RegisterServerResult, type RegisterFileParams, type CreateGrantParams, type RevokeGrantParams, type DeleteFileParams, type GatewayClient, } from "./protocol/gateway";
+export { createEscrowGatewayClient, genericPaymentDomain, GENERIC_PAYMENT_TYPES, ESCROW_DEPOSIT_ABI, NATIVE_ASSET_ADDRESS, type GenericPaymentMessage, type EscrowBalanceEntry, type EscrowBalanceResult, type EscrowBalanceSyncResult, type DepositSubmissionResult, type PaymentBreakdown, type EscrowPayResult, type SubmitDepositParams, type PayForOpParams, type EscrowGatewayClient, type SubmittedDepositEntry, type FinalizedDepositEntry, type FailedDepositEntry, } from "./protocol/escrow";
 export { PSError, parsePSError, type PSErrorCode } from "./types/ps-errors";

package/dist/index.node.js

@@ -29018,6 +29018,8 @@ async function buildWeb3SignedHeader(params) {
 var DEFAULT_ENDPOINT = "https://storage.vana.org";
 var BLOB_PATH_PREFIX = "/v1/blobs";
 var DEFAULT_TOKEN_TTL_SECONDS = 300;
+var MAX_UPLOAD_ATTEMPTS = 4;
+var MAX_RATE_LIMIT_DELAY_MS = 3e4;
 var VanaStorage = class {
   endpoint;
   signer;
@@ -29056,27 +29058,46 @@ var VanaStorage = class {
     const body = new Uint8Array(await file.arrayBuffer());
     const contentType = file.type !== "" ? file.type : "application/octet-stream";
     const header = await this.signRequest("PUT", path, body);
-    let response;
-    try {
-      response = await this.fetchImpl(`${this.endpoint}${path}`, {
-        method: "PUT",
-        headers: {
-          authorization: header,
-          "content-type": contentType
-        },
-        body
-      });
-    } catch (cause) {
+    let response = null;
+    let responseText = "";
+    for (let attempt = 1; attempt <= MAX_UPLOAD_ATTEMPTS; attempt++) {
+      try {
+        response = await this.fetchImpl(`${this.endpoint}${path}`, {
+          method: "PUT",
+          headers: {
+            authorization: header,
+            "content-type": contentType
+          },
+          body
+        });
+      } catch (cause) {
+        throw new StorageError(
+          `vana-storage upload network error: ${describe(cause)}`,
+          "UPLOAD_ERROR",
+          "vana-storage",
+          { cause: cause instanceof Error ? cause : void 0 }
+        );
+      }
+      if (response.ok) {
+        break;
+      }
+      responseText = await safeText(response);
+      if (response.status === 429 && attempt < MAX_UPLOAD_ATTEMPTS) {
+        const delayMs = retryDelayMs(response, responseText);
+        if (delayMs > 0) {
+          await sleep(delayMs);
+        }
+        continue;
+      }
       throw new StorageError(
-        `vana-storage upload network error: ${describe(cause)}`,
-        "UPLOAD_ERROR",
-        "vana-storage",
-        { cause: cause instanceof Error ? cause : void 0 }
+        `vana-storage upload failed: ${response.status} ${response.statusText} - ${responseText}`,
+        "UPLOAD_FAILED",
+        "vana-storage"
       );
     }
-    if (!response.ok) {
+    if (!response?.ok) {
       throw new StorageError(
-        `vana-storage upload failed: ${response.status} ${response.statusText} - ${await safeText(response)}`,
+        `vana-storage upload failed after ${MAX_UPLOAD_ATTEMPTS} attempts - ${responseText}`,
         "UPLOAD_FAILED",
         "vana-storage"
       );
@@ -29229,6 +29250,43 @@ function describe(value) {
   if (value instanceof Error) return value.message;
   return String(value);
 }
+function retryDelayMs(response, responseText) {
+  const headerDelayMs = parseRetryAfterHeaderMs(
+    response.headers.get("retry-after")
+  );
+  if (headerDelayMs !== null) {
+    return clampRateLimitDelay(headerDelayMs);
+  }
+  return clampRateLimitDelay(parseRetryAfterBodyMs(responseText) ?? 0);
+}
+function parseRetryAfterHeaderMs(value) {
+  if (!value) return null;
+  const seconds = Number(value);
+  if (Number.isFinite(seconds)) {
+    return seconds * 1e3;
+  }
+  const dateMs = Date.parse(value);
+  if (Number.isFinite(dateMs)) {
+    return Math.max(0, dateMs - Date.now());
+  }
+  return null;
+}
+function parseRetryAfterBodyMs(responseText) {
+  if (!responseText) return null;
+  try {
+    const parsed = JSON.parse(responseText);
+    const seconds = Number(parsed.retryAfter);
+    return Number.isFinite(seconds) ? seconds * 1e3 : null;
+  } catch {
+    return null;
+  }
+}
+function clampRateLimitDelay(delayMs) {
+  return Math.min(Math.max(0, delayMs), MAX_RATE_LIMIT_DELAY_MS);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 async function safeText(response) {
   try {
     return await response.text();
@@ -32601,8 +32659,11 @@ var BUILDER_REGISTRATION_TYPES = {
 import {
   isAddress
 } from "viem";
-var PERSONAL_SERVER_REGISTRATION_DEFAULT_CHAIN_ID = 1480;
-var PERSONAL_SERVER_REGISTRATION_DEFAULT_VERIFYING_CONTRACT = "0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c";
+var PERSONAL_SERVER_REGISTRATION_DEFAULT_CHAIN_ID = vanaMainnet2.id;
+var PERSONAL_SERVER_REGISTRATION_DEFAULT_VERIFYING_CONTRACT = getContractAddress(
+  PERSONAL_SERVER_REGISTRATION_DEFAULT_CHAIN_ID,
+  "DataPortabilityServers"
+);
 function assertAddress(value, name) {
   if (!isAddress(value)) {
     throw new Error(`${name} must be a valid EVM address`);
@@ -32617,6 +32678,12 @@ function getAccountAddress(account) {
 function isPersonalServerRegistrationSigner(source) {
   return "address" in source && typeof source.signTypedData === "function";
 }
+function getDefaultServerRegistrationContract(chainId) {
+  return getContractAddress(
+    chainId,
+    "DataPortabilityServers"
+  );
+}
 function createViemPersonalServerRegistrationSigner(source, options = {}) {
   if (isPersonalServerRegistrationSigner(source)) {
     return source;
@@ -32639,12 +32706,13 @@ function personalServerRegistrationDomain(input = {}) {
   if (input.config) {
     return serverRegistrationDomain(input.config);
   }
-  const verifyingContract = input.verifyingContract ?? PERSONAL_SERVER_REGISTRATION_DEFAULT_VERIFYING_CONTRACT;
+  const chainId = input.chainId ?? PERSONAL_SERVER_REGISTRATION_DEFAULT_CHAIN_ID;
+  const verifyingContract = input.verifyingContract ?? getDefaultServerRegistrationContract(chainId);
   assertAddress(verifyingContract, "verifyingContract");
   return {
     name: "Vana Data Portability",
     version: "1",
-    chainId: input.chainId ?? PERSONAL_SERVER_REGISTRATION_DEFAULT_CHAIN_ID,
+    chainId,
     verifyingContract
   };
 }
@@ -32682,11 +32750,11 @@ async function buildPersonalServerRegistrationSignature(input) {
 }
 var registerPersonalServerSignature = buildPersonalServerRegistrationSignature;
 
-// src/protocol/personal-server-lite-owner-binding.ts
+// src/personal-server-lite/owner-binding.ts
 import {
   isAddress as isAddress2
 } from "viem";
-var PERSONAL_SERVER_LITE_OWNER_BINDING_VERSION = "vana.account.v1";
+var PERSONAL_SERVER_LITE_OWNER_BINDING_VERSION = "vana.ps-lite.owner-binding.v1";
 var PERSONAL_SERVER_LITE_OWNER_BINDING_PURPOSE = "ps-lite-owner";
 var PERSONAL_SERVER_LITE_OWNER_BINDING_PREFIX = `${PERSONAL_SERVER_LITE_OWNER_BINDING_VERSION}:${PERSONAL_SERVER_LITE_OWNER_BINDING_PURPOSE}:`;
 function assertAddress2(value, name) {
@@ -33429,6 +33497,118 @@ function createGatewayClient(baseUrl) {
   };
 }
 
+// src/protocol/escrow.ts
+var GENERIC_PAYMENT_TYPES = {
+  GenericPayment: [
+    { name: "payerAddress", type: "address" },
+    { name: "opType", type: "string" },
+    { name: "opId", type: "bytes32" },
+    { name: "asset", type: "address" },
+    { name: "amount", type: "uint256" },
+    { name: "paymentNonce", type: "uint256" }
+  ]
+};
+function genericPaymentDomain(chainId, escrowContract) {
+  return {
+    name: "Vana Data Portability",
+    version: "1",
+    chainId,
+    verifyingContract: escrowContract
+  };
+}
+var ESCROW_DEPOSIT_ABI = [
+  {
+    type: "function",
+    name: "depositNative",
+    stateMutability: "payable",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: []
+  },
+  {
+    type: "function",
+    name: "depositToken",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "account", type: "address" },
+      { name: "token", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    outputs: []
+  }
+];
+var NATIVE_ASSET_ADDRESS = "0x0000000000000000000000000000000000000000";
+function createEscrowGatewayClient(baseUrl) {
+  const base = baseUrl.replace(/\/+$/, "");
+  async function throwOnError(res, context) {
+    if (!res.ok) {
+      let detail = "";
+      try {
+        const body = await res.json();
+        if (body.error) detail = `: ${body.error}`;
+      } catch {
+      }
+      throw new Error(
+        `Escrow gateway error (${context}): ${res.status} ${res.statusText}${detail}`
+      );
+    }
+  }
+  return {
+    async submitDeposit({ txHash }) {
+      const res = await fetch(`${base}/v1/escrow/deposit`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ txHash })
+      });
+      if (res.status !== 200 && res.status !== 202) {
+        await throwOnError(res, "POST /v1/escrow/deposit");
+      }
+      return res.json();
+    },
+    async getEscrowBalance(account) {
+      const res = await fetch(
+        `${base}/v1/escrow/balance?account=${encodeURIComponent(account)}`
+      );
+      await throwOnError(res, "GET /v1/escrow/balance");
+      return res.json();
+    },
+    async syncEscrowBalance(account) {
+      const res = await fetch(
+        `${base}/v1/escrow/balance/sync?account=${encodeURIComponent(account)}`,
+        { method: "POST" }
+      );
+      await throwOnError(res, "POST /v1/escrow/balance/sync");
+      return res.json();
+    },
+    async payForOp({
+      payerAddress,
+      opType,
+      opId,
+      asset,
+      amount,
+      paymentNonce,
+      signature
+    }) {
+      const res = await fetch(`${base}/v1/escrow/pay`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Web3Signed ${signature}`
+        },
+        body: JSON.stringify({
+          payerAddress,
+          opType,
+          opId,
+          asset,
+          amount,
+          paymentNonce
+        })
+      });
+      await throwOnError(res, "POST /v1/escrow/pay");
+      return res.json();
+    }
+  };
+}
+
 // src/types/ps-errors.ts
 var PSError = class extends Error {
   constructor(code, message) {
@@ -33505,9 +33685,11 @@ export {
   DataFileEnvelopeSchema,
   DropboxStorage,
   ECIESError,
+  ESCROW_DEPOSIT_ABI,
   ExpiredTokenError,
   FILE_DELETION_TYPES,
   FILE_REGISTRATION_TYPES,
+  GENERIC_PAYMENT_TYPES,
   GRANT_REGISTRATION_TYPES,
   GRANT_REVOCATION_TYPES,
   GoogleDriveStorage,
@@ -33518,6 +33700,7 @@ export {
   IpfsStorage,
   MASTER_KEY_MESSAGE,
   MissingAuthError,
+  NATIVE_ASSET_ADDRESS,
   NetworkError,
   NodeECIESUint8Provider as NodeECIESProvider,
   NodePlatformAdapter,
@@ -33562,6 +33745,7 @@ export {
   contractCacheForTesting,
   createBrowserPlatformAdapter,
   createDataFileEnvelope,
+  createEscrowGatewayClient,
   createGatewayClient,
   createNodePlatformAdapter,
   createPlatformAdapter,
@@ -33579,6 +33763,7 @@ export {
   fileDeletionDomain,
   fileRegistrationDomain,
   generatePkceVerifier,
+  genericPaymentDomain,
   getAbi,
   getAllChains,
   getChainConfig,