@opendatalabs/vana-sdk 3.4.1 → 3.5.1-pr.159.12a6f39

package/dist/protocol/eip712.d.ts

@@ -12,38 +12,20 @@ export interface DataPortabilityContracts {
     dataPortabilityPermissions: string;
     dataPortabilityServer: string;
     dataPortabilityGrantees: string;
+    dataPortabilityEscrow: string;
+    feeRegistry: string;
 }
+export declare const NATIVE_VANA_ASSET: "0x0000000000000000000000000000000000000000";
 export interface DataPortabilityGatewayConfig {
     chainId: number;
     contracts: DataPortabilityContracts;
 }
-export declare function fileRegistrationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
-export declare function fileDeletionDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
+export declare function dataRegistryDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
 export declare function grantRegistrationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
 export declare function grantRevocationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
 export declare function serverRegistrationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
 export declare function builderRegistrationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
-export declare const FILE_REGISTRATION_TYPES: {
-    readonly FileRegistration: readonly [{
-        readonly name: "ownerAddress";
-        readonly type: "address";
-    }, {
-        readonly name: "url";
-        readonly type: "string";
-    }, {
-        readonly name: "schemaId";
-        readonly type: "bytes32";
-    }];
-};
-export declare const FILE_DELETION_TYPES: {
-    readonly FileDeletion: readonly [{
-        readonly name: "ownerAddress";
-        readonly type: "address";
-    }, {
-        readonly name: "fileId";
-        readonly type: "bytes32";
-    }];
-};
+export declare function escrowPaymentDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
 export declare const GRANT_REGISTRATION_TYPES: {
     readonly GrantRegistration: readonly [{
         readonly name: "grantorAddress";
@@ -52,11 +34,14 @@ export declare const GRANT_REGISTRATION_TYPES: {
         readonly name: "granteeId";
         readonly type: "bytes32";
     }, {
-        readonly name: "grant";
-        readonly type: "string";
+        readonly name: "scopes";
+        readonly type: "string[]";
     }, {
-        readonly name: "fileIds";
-        readonly type: "uint256[]";
+        readonly name: "grantVersion";
+        readonly type: "uint256";
+    }, {
+        readonly name: "expiresAt";
+        readonly type: "uint256";
     }];
 };
 export declare const GRANT_REVOCATION_TYPES: {
@@ -66,6 +51,9 @@ export declare const GRANT_REVOCATION_TYPES: {
     }, {
         readonly name: "grantId";
         readonly type: "bytes32";
+    }, {
+        readonly name: "grantVersion";
+        readonly type: "uint256";
     }];
 };
 export declare const SERVER_REGISTRATION_TYPES: {
@@ -98,29 +86,74 @@ export declare const BUILDER_REGISTRATION_TYPES: {
         readonly type: "string";
     }];
 };
-export interface FileRegistrationMessage {
-    ownerAddress: `0x${string}`;
-    url: string;
-    schemaId: `0x${string}`;
-}
-export interface FileDeletionMessage {
-    ownerAddress: `0x${string}`;
-    /**
-     * Off-chain gateway file ID — bytes32, as returned by `GET /v1/files`. This is NOT the on-chain
-     * uint256 DataRegistry file ID; consumers (e.g. the PS delete cascade) must source it from the
-     * gateway, not derive it from a numeric on-chain ID.
-     */
-    fileId: `0x${string}`;
-}
+export declare const GENERIC_PAYMENT_TYPES: {
+    readonly GenericPayment: readonly [{
+        readonly name: "payerAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "opType";
+        readonly type: "string";
+    }, {
+        readonly name: "opId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "asset";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "paymentNonce";
+        readonly type: "uint256";
+    }];
+};
+export declare const ADD_DATA_TYPES: {
+    readonly AddData: readonly [{
+        readonly name: "ownerAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "scope";
+        readonly type: "string";
+    }, {
+        readonly name: "dataHash";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "metadataHash";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "expectedVersion";
+        readonly type: "uint256";
+    }];
+};
+export declare const RECORD_DATA_ACCESS_TYPES: {
+    readonly RecordDataAccess: readonly [{
+        readonly name: "ownerAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "scope";
+        readonly type: "string";
+    }, {
+        readonly name: "version";
+        readonly type: "uint256";
+    }, {
+        readonly name: "accessor";
+        readonly type: "address";
+    }, {
+        readonly name: "recordId";
+        readonly type: "bytes32";
+    }];
+};
 export interface GrantRegistrationMessage {
     grantorAddress: `0x${string}`;
     granteeId: `0x${string}`;
-    grant: string;
-    fileIds: bigint[];
+    scopes: string[];
+    grantVersion: bigint;
+    expiresAt: bigint;
 }
 export interface GrantRevocationMessage {
     grantorAddress: `0x${string}`;
     grantId: `0x${string}`;
+    grantVersion: bigint;
 }
 export interface ServerRegistrationMessage {
     ownerAddress: `0x${string}`;
@@ -134,3 +167,25 @@ export interface BuilderRegistrationMessage {
     publicKey: string;
     appUrl: string;
 }
+export interface GenericPaymentMessage {
+    payerAddress: `0x${string}`;
+    opType: string;
+    opId: `0x${string}`;
+    asset: `0x${string}`;
+    amount: bigint;
+    paymentNonce: bigint;
+}
+export interface AddDataMessage {
+    ownerAddress: `0x${string}`;
+    scope: string;
+    dataHash: `0x${string}`;
+    metadataHash: `0x${string}`;
+    expectedVersion: bigint;
+}
+export interface RecordDataAccessMessage {
+    ownerAddress: `0x${string}`;
+    scope: string;
+    version: bigint;
+    accessor: `0x${string}`;
+    recordId: `0x${string}`;
+}

package/dist/protocol/eip712.js

@@ -1,5 +1,6 @@
 const DOMAIN_NAME = "Vana Data Portability";
 const DOMAIN_VERSION = "1";
+const NATIVE_VANA_ASSET = "0x0000000000000000000000000000000000000000";
 function buildDomain(chainId, verifyingContract) {
   return {
     name: DOMAIN_NAME,
@@ -8,13 +9,7 @@ function buildDomain(chainId, verifyingContract) {
     verifyingContract
   };
 }
-function fileRegistrationDomain(config) {
-  return buildDomain(
-    config.chainId,
-    config.contracts.dataRegistry
-  );
-}
-function fileDeletionDomain(config) {
+function dataRegistryDomain(config) {
   return buildDomain(
     config.chainId,
     config.contracts.dataRegistry
@@ -44,31 +39,26 @@ function builderRegistrationDomain(config) {
     config.contracts.dataPortabilityGrantees
   );
 }
-const FILE_REGISTRATION_TYPES = {
-  FileRegistration: [
-    { name: "ownerAddress", type: "address" },
-    { name: "url", type: "string" },
-    { name: "schemaId", type: "bytes32" }
-  ]
-};
-const FILE_DELETION_TYPES = {
-  FileDeletion: [
-    { name: "ownerAddress", type: "address" },
-    { name: "fileId", type: "bytes32" }
-  ]
-};
+function escrowPaymentDomain(config) {
+  return buildDomain(
+    config.chainId,
+    config.contracts.dataPortabilityEscrow
+  );
+}
 const GRANT_REGISTRATION_TYPES = {
   GrantRegistration: [
     { name: "grantorAddress", type: "address" },
     { name: "granteeId", type: "bytes32" },
-    { name: "grant", type: "string" },
-    { name: "fileIds", type: "uint256[]" }
+    { name: "scopes", type: "string[]" },
+    { name: "grantVersion", type: "uint256" },
+    { name: "expiresAt", type: "uint256" }
   ]
 };
 const GRANT_REVOCATION_TYPES = {
   GrantRevocation: [
     { name: "grantorAddress", type: "address" },
-    { name: "grantId", type: "bytes32" }
+    { name: "grantId", type: "bytes32" },
+    { name: "grantVersion", type: "uint256" }
   ]
 };
 const SERVER_REGISTRATION_TYPES = {
@@ -87,16 +77,46 @@ const BUILDER_REGISTRATION_TYPES = {
     { name: "appUrl", type: "string" }
   ]
 };
+const 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" }
+  ]
+};
+const ADD_DATA_TYPES = {
+  AddData: [
+    { name: "ownerAddress", type: "address" },
+    { name: "scope", type: "string" },
+    { name: "dataHash", type: "bytes32" },
+    { name: "metadataHash", type: "bytes32" },
+    { name: "expectedVersion", type: "uint256" }
+  ]
+};
+const RECORD_DATA_ACCESS_TYPES = {
+  RecordDataAccess: [
+    { name: "ownerAddress", type: "address" },
+    { name: "scope", type: "string" },
+    { name: "version", type: "uint256" },
+    { name: "accessor", type: "address" },
+    { name: "recordId", type: "bytes32" }
+  ]
+};
 export {
+  ADD_DATA_TYPES,
   BUILDER_REGISTRATION_TYPES,
-  FILE_DELETION_TYPES,
-  FILE_REGISTRATION_TYPES,
+  GENERIC_PAYMENT_TYPES,
   GRANT_REGISTRATION_TYPES,
   GRANT_REVOCATION_TYPES,
+  NATIVE_VANA_ASSET,
+  RECORD_DATA_ACCESS_TYPES,
   SERVER_REGISTRATION_TYPES,
   builderRegistrationDomain,
-  fileDeletionDomain,
-  fileRegistrationDomain,
+  dataRegistryDomain,
+  escrowPaymentDomain,
   grantRegistrationDomain,
   grantRevocationDomain,
   serverRegistrationDomain

package/dist/protocol/eip712.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/protocol/eip712.ts"],"sourcesContent":["/**\n * EIP-712 domain and type builders for Data Portability protocol writes.\n *\n * These helpers are shared primitives only. Personal Server runtimes own when\n * to sign and submit these payloads.\n *\n * @category Protocol\n */\n\nimport type { TypedDataDomain } from \"viem\";\n\nconst DOMAIN_NAME = \"Vana Data Portability\";\nconst DOMAIN_VERSION = \"1\";\n\nexport interface DataPortabilityContracts {\n  dataRegistry: string;\n  dataPortabilityPermissions: string;\n  dataPortabilityServer: string;\n  dataPortabilityGrantees: string;\n}\n\nexport interface DataPortabilityGatewayConfig {\n  chainId: number;\n  contracts: DataPortabilityContracts;\n}\n\nfunction buildDomain(\n  chainId: number,\n  verifyingContract: `0x${string}`,\n): TypedDataDomain {\n  return {\n    name: DOMAIN_NAME,\n    version: DOMAIN_VERSION,\n    chainId,\n    verifyingContract,\n  };\n}\n\nexport function fileRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataRegistry as `0x${string}`,\n  );\n}\n\nexport function fileDeletionDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataRegistry as `0x${string}`,\n  );\n}\n\nexport function grantRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityPermissions as `0x${string}`,\n  );\n}\n\nexport function grantRevocationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityPermissions as `0x${string}`,\n  );\n}\n\nexport function serverRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityServer as `0x${string}`,\n  );\n}\n\nexport function builderRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityGrantees as `0x${string}`,\n  );\n}\n\nexport const FILE_REGISTRATION_TYPES = {\n  FileRegistration: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"url\", type: \"string\" },\n    { name: \"schemaId\", type: \"bytes32\" },\n  ],\n} as const;\n\nexport const FILE_DELETION_TYPES = {\n  FileDeletion: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"fileId\", type: \"bytes32\" },\n  ],\n} as const;\n\nexport const GRANT_REGISTRATION_TYPES = {\n  GrantRegistration: [\n    { name: \"grantorAddress\", type: \"address\" },\n    { name: \"granteeId\", type: \"bytes32\" },\n    { name: \"grant\", type: \"string\" },\n    { name: \"fileIds\", type: \"uint256[]\" },\n  ],\n} as const;\n\nexport const GRANT_REVOCATION_TYPES = {\n  GrantRevocation: [\n    { name: \"grantorAddress\", type: \"address\" },\n    { name: \"grantId\", type: \"bytes32\" },\n  ],\n} as const;\n\nexport const SERVER_REGISTRATION_TYPES = {\n  ServerRegistration: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"serverAddress\", type: \"address\" },\n    { name: \"publicKey\", type: \"string\" },\n    { name: \"serverUrl\", type: \"string\" },\n  ],\n} as const;\n\nexport const BUILDER_REGISTRATION_TYPES = {\n  BuilderRegistration: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"granteeAddress\", type: \"address\" },\n    { name: \"publicKey\", type: \"string\" },\n    { name: \"appUrl\", type: \"string\" },\n  ],\n} as const;\n\nexport interface FileRegistrationMessage {\n  ownerAddress: `0x${string}`;\n  url: string;\n  schemaId: `0x${string}`;\n}\n\nexport interface FileDeletionMessage {\n  ownerAddress: `0x${string}`;\n  /**\n   * Off-chain gateway file ID — bytes32, as returned by `GET /v1/files`. This is NOT the on-chain\n   * uint256 DataRegistry file ID; consumers (e.g. the PS delete cascade) must source it from the\n   * gateway, not derive it from a numeric on-chain ID.\n   */\n  fileId: `0x${string}`;\n}\n\nexport interface GrantRegistrationMessage {\n  grantorAddress: `0x${string}`;\n  granteeId: `0x${string}`;\n  grant: string;\n  fileIds: bigint[];\n}\n\nexport interface GrantRevocationMessage {\n  grantorAddress: `0x${string}`;\n  grantId: `0x${string}`;\n}\n\nexport interface ServerRegistrationMessage {\n  ownerAddress: `0x${string}`;\n  serverAddress: `0x${string}`;\n  publicKey: string;\n  serverUrl: string;\n}\n\nexport interface BuilderRegistrationMessage {\n  ownerAddress: `0x${string}`;\n  granteeAddress: `0x${string}`;\n  publicKey: string;\n  appUrl: string;\n}\n"],"mappings":"AAWA,MAAM,cAAc;AACpB,MAAM,iBAAiB;AAcvB,SAAS,YACP,SACA,mBACiB;AACjB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,uBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,mBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,wBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,sBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,yBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,0BACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,MAAM,0BAA0B;AAAA,EACrC,kBAAkB;AAAA,IAChB,EAAE,MAAM,gBAAgB,MAAM,UAAU;AAAA,IACxC,EAAE,MAAM,OAAO,MAAM,SAAS;AAAA,IAC9B,EAAE,MAAM,YAAY,MAAM,UAAU;AAAA,EACtC;AACF;AAEO,MAAM,sBAAsB;AAAA,EACjC,cAAc;AAAA,IACZ,EAAE,MAAM,gBAAgB,MAAM,UAAU;AAAA,IACxC,EAAE,MAAM,UAAU,MAAM,UAAU;AAAA,EACpC;AACF;AAEO,MAAM,2BAA2B;AAAA,EACtC,mBAAmB;AAAA,IACjB,EAAE,MAAM,kBAAkB,MAAM,UAAU;AAAA,IAC1C,EAAE,MAAM,aAAa,MAAM,UAAU;AAAA,IACrC,EAAE,MAAM,SAAS,MAAM,SAAS;AAAA,IAChC,EAAE,MAAM,WAAW,MAAM,YAAY;AAAA,EACvC;AACF;AAEO,MAAM,yBAAyB;AAAA,EACpC,iBAAiB;AAAA,IACf,EAAE,MAAM,kBAAkB,MAAM,UAAU;AAAA,IAC1C,EAAE,MAAM,WAAW,MAAM,UAAU;AAAA,EACrC;AACF;AAEO,MAAM,4BAA4B;AAAA,EACvC,oBAAoB;AAAA,IAClB,EAAE,MAAM,gBAAgB,MAAM,UAAU;AAAA,IACxC,EAAE,MAAM,iBAAiB,MAAM,UAAU;AAAA,IACzC,EAAE,MAAM,aAAa,MAAM,SAAS;AAAA,IACpC,EAAE,MAAM,aAAa,MAAM,SAAS;AAAA,EACtC;AACF;AAEO,MAAM,6BAA6B;AAAA,EACxC,qBAAqB;AAAA,IACnB,EAAE,MAAM,gBAAgB,MAAM,UAAU;AAAA,IACxC,EAAE,MAAM,kBAAkB,MAAM,UAAU;AAAA,IAC1C,EAAE,MAAM,aAAa,MAAM,SAAS;AAAA,IACpC,EAAE,MAAM,UAAU,MAAM,SAAS;AAAA,EACnC;AACF;","names":[]}
+{"version":3,"sources":["../../src/protocol/eip712.ts"],"sourcesContent":["/**\n * EIP-712 domain and type builders for Data Portability protocol writes.\n *\n * These helpers are shared primitives only. Personal Server runtimes own when\n * to sign and submit these payloads.\n *\n * @category Protocol\n */\n\nimport type { TypedDataDomain } from \"viem\";\n\nconst DOMAIN_NAME = \"Vana Data Portability\";\nconst DOMAIN_VERSION = \"1\";\n\nexport interface DataPortabilityContracts {\n  dataRegistry: string;\n  dataPortabilityPermissions: string;\n  dataPortabilityServer: string;\n  dataPortabilityGrantees: string;\n  // DataPortabilityEscrow — verifies GENERIC_PAYMENT_TYPES signatures backing\n  // /v1/escrow/pay (the data-access payment path).\n  dataPortabilityEscrow: string;\n  // FeeRegistry — per-operation `{amount, asset, payee, enabled}` records\n  // keyed on `keccak256(name)`. The gateway re-resolves fees against this\n  // contract on every /v1/escrow/pay so the SDK has to read the same\n  // source of truth to size payment amounts.\n  feeRegistry: string;\n}\n\n// Native VANA asset sentinel used by /v1/escrow/pay's `asset` field — pay any\n// other ERC-20 by passing its contract address instead.\nexport const NATIVE_VANA_ASSET =\n  \"0x0000000000000000000000000000000000000000\" as const;\n\nexport interface DataPortabilityGatewayConfig {\n  chainId: number;\n  contracts: DataPortabilityContracts;\n}\n\nfunction buildDomain(\n  chainId: number,\n  verifyingContract: `0x${string}`,\n): TypedDataDomain {\n  return {\n    name: DOMAIN_NAME,\n    version: DOMAIN_VERSION,\n    chainId,\n    verifyingContract,\n  };\n}\n\n// Domain for the DataRegistryV2 contract — verifies the AddData and\n// RecordDataAccess EIP-712 signatures. The v2 contract dropped the file\n// concept entirely in favor of versioned data points keyed on (owner,\n// scope); the primaryType distinguishes the two flows.\nexport function dataRegistryDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataRegistry as `0x${string}`,\n  );\n}\n\nexport function grantRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityPermissions as `0x${string}`,\n  );\n}\n\nexport function grantRevocationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityPermissions as `0x${string}`,\n  );\n}\n\nexport function serverRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityServer as `0x${string}`,\n  );\n}\n\nexport function builderRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityGrantees as `0x${string}`,\n  );\n}\n\n// Domain for the generic-payment EIP-712 signature consumed by\n// /v1/escrow/pay. The verifyingContract is the escrow itself (not the per-op\n// contract), so a single signature debits the payer's escrow balance for any\n// supported op — `grant` today; file/builder/schema in the future.\nexport function escrowPaymentDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityEscrow as `0x${string}`,\n  );\n}\n\n// grantVersion is a monotonic uint256 nonce per (grantor, grantee) pair. The\n// gateway rejects any registration whose version is <= the stored value,\n// which is the replay-attack defence now that re-registering the same pair\n// is a permitted override. expiresAt is unix seconds; 0 = no expiry.\nexport const GRANT_REGISTRATION_TYPES = {\n  GrantRegistration: [\n    { name: \"grantorAddress\", type: \"address\" },\n    { name: \"granteeId\", type: \"bytes32\" },\n    { name: \"scopes\", type: \"string[]\" },\n    { name: \"grantVersion\", type: \"uint256\" },\n    { name: \"expiresAt\", type: \"uint256\" },\n  ],\n} as const;\n\n// Revocation shares the (grantor, grantee) monotonic nonce with registration —\n// both events advance the same grantVersion counter so an old revocation sig\n// can't be replayed across a revoke → re-register cycle.\nexport const GRANT_REVOCATION_TYPES = {\n  GrantRevocation: [\n    { name: \"grantorAddress\", type: \"address\" },\n    { name: \"grantId\", type: \"bytes32\" },\n    { name: \"grantVersion\", type: \"uint256\" },\n  ],\n} as const;\n\nexport const SERVER_REGISTRATION_TYPES = {\n  ServerRegistration: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"serverAddress\", type: \"address\" },\n    { name: \"publicKey\", type: \"string\" },\n    { name: \"serverUrl\", type: \"string\" },\n  ],\n} as const;\n\nexport const BUILDER_REGISTRATION_TYPES = {\n  BuilderRegistration: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"granteeAddress\", type: \"address\" },\n    { name: \"publicKey\", type: \"string\" },\n    { name: \"appUrl\", type: \"string\" },\n  ],\n} as const;\n\n// Generic payment for the escrow flow. The (opType, opId) pair routes the\n// debit to the right op-row; paymentNonce is per-payer monotonic so the same\n// signed message can't be replayed after a revoke + re-register cycle.\n//\n// Today opType is always 'grant' and opId is the bytes32 grantId.\nexport const GENERIC_PAYMENT_TYPES = {\n  GenericPayment: [\n    { name: \"payerAddress\", type: \"address\" },\n    { name: \"opType\", type: \"string\" },\n    { name: \"opId\", type: \"bytes32\" },\n    { name: \"asset\", type: \"address\" },\n    { name: \"amount\", type: \"uint256\" },\n    { name: \"paymentNonce\", type: \"uint256\" },\n  ],\n} as const;\n\n// AddData is signed by the data point's owner — registers (scope, dataHash,\n// metadataHash) on DataRegistryV2. expectedVersion is the version the caller\n// believes is current; the contract rejects with a CAS error if it isn't.\n// Used at POST /v1/data.\nexport const ADD_DATA_TYPES = {\n  AddData: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"scope\", type: \"string\" },\n    { name: \"dataHash\", type: \"bytes32\" },\n    { name: \"metadataHash\", type: \"bytes32\" },\n    { name: \"expectedVersion\", type: \"uint256\" },\n  ],\n} as const;\n\n// RecordDataAccess is signed by a *trusted personal server* of `ownerAddress`\n// — attests that (scope, version) was served to `accessor`. recordId is a\n// per-event bytes32 the contract pins in `_usedRecordIds` to prevent replay.\n// Used as the optional `accessRecord` on POST /v1/escrow/pay.\nexport const RECORD_DATA_ACCESS_TYPES = {\n  RecordDataAccess: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"scope\", type: \"string\" },\n    { name: \"version\", type: \"uint256\" },\n    { name: \"accessor\", type: \"address\" },\n    { name: \"recordId\", type: \"bytes32\" },\n  ],\n} as const;\n\nexport interface GrantRegistrationMessage {\n  grantorAddress: `0x${string}`;\n  granteeId: `0x${string}`;\n  scopes: string[];\n  grantVersion: bigint;\n  expiresAt: bigint;\n}\n\nexport interface GrantRevocationMessage {\n  grantorAddress: `0x${string}`;\n  grantId: `0x${string}`;\n  grantVersion: bigint;\n}\n\nexport interface ServerRegistrationMessage {\n  ownerAddress: `0x${string}`;\n  serverAddress: `0x${string}`;\n  publicKey: string;\n  serverUrl: string;\n}\n\nexport interface BuilderRegistrationMessage {\n  ownerAddress: `0x${string}`;\n  granteeAddress: `0x${string}`;\n  publicKey: string;\n  appUrl: string;\n}\n\nexport interface GenericPaymentMessage {\n  payerAddress: `0x${string}`;\n  // 'grant' today — extensible to 'file' | 'builder' | 'schema' as those\n  // op-types become payable. Sent verbatim over the wire and into the\n  // typed-data string field, so callers must match the gateway's spelling.\n  opType: string;\n  opId: `0x${string}`;\n  // NATIVE_VANA_ASSET for native VANA; an ERC-20 contract address otherwise.\n  asset: `0x${string}`;\n  amount: bigint;\n  paymentNonce: bigint;\n}\n\nexport interface AddDataMessage {\n  ownerAddress: `0x${string}`;\n  scope: string;\n  dataHash: `0x${string}`;\n  metadataHash: `0x${string}`;\n  expectedVersion: bigint;\n}\n\nexport interface RecordDataAccessMessage {\n  ownerAddress: `0x${string}`;\n  scope: string;\n  version: bigint;\n  accessor: `0x${string}`;\n  recordId: `0x${string}`;\n}\n"],"mappings":"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","names":[]}

package/dist/protocol/escrow-deposit.cjs

@@ -0,0 +1,89 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var escrow_deposit_exports = {};
+__export(escrow_deposit_exports, {
+  ESCROW_DEPOSIT_ABI: () => ESCROW_DEPOSIT_ABI,
+  buildDepositNativeRequest: () => buildDepositNativeRequest,
+  buildDepositTokenRequest: () => buildDepositTokenRequest,
+  encodeDepositNativeData: () => encodeDepositNativeData,
+  encodeDepositTokenData: () => encodeDepositTokenData,
+  escrowContractAddress: () => escrowContractAddress
+});
+module.exports = __toCommonJS(escrow_deposit_exports);
+var import_viem = require("viem");
+const 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: []
+  }
+];
+function escrowContractAddress(config) {
+  return config.contracts.dataPortabilityEscrow;
+}
+function encodeDepositNativeData(input) {
+  return (0, import_viem.encodeFunctionData)({
+    abi: ESCROW_DEPOSIT_ABI,
+    functionName: "depositNative",
+    args: [input.account]
+  });
+}
+function encodeDepositTokenData(input) {
+  return (0, import_viem.encodeFunctionData)({
+    abi: ESCROW_DEPOSIT_ABI,
+    functionName: "depositToken",
+    args: [input.account, input.token, input.amount]
+  });
+}
+function buildDepositNativeRequest(config, input) {
+  return {
+    to: escrowContractAddress(config),
+    data: encodeDepositNativeData({ account: input.account }),
+    value: input.amount
+  };
+}
+function buildDepositTokenRequest(config, input) {
+  return {
+    to: escrowContractAddress(config),
+    data: encodeDepositTokenData(input)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ESCROW_DEPOSIT_ABI,
+  buildDepositNativeRequest,
+  buildDepositTokenRequest,
+  encodeDepositNativeData,
+  encodeDepositTokenData,
+  escrowContractAddress
+});
+//# sourceMappingURL=escrow-deposit.cjs.map

package/dist/protocol/escrow-deposit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/escrow-deposit.ts"],"sourcesContent":["/**\n * On-chain deposit primitives for the DataPortabilityEscrow contract.\n *\n * The escrow holds the finalized balance that `/v1/escrow/pay` debits against.\n * A payer credits their balance by sending one of two function calls to the\n * escrow contract — depositNative (native VANA, amount via `msg.value`) or\n * depositToken (ERC-20, caller must `approve` the escrow first). The credited\n * `account` need not equal `msg.sender`, so a third party can fund someone\n * else's escrow.\n *\n * Once the on-chain tx lands, call `GatewayClient.submitEscrowDeposit({txHash})`\n * to announce it; the gateway reconciles it into the balance and surfaces it\n * under `getEscrowBalance(account).deposits.finalized`.\n *\n * These helpers are signer/transport-agnostic — they return the raw\n * `{to, data, value?}` request object so callers can feed it to any wallet\n * stack (viem `sendTransaction`/`writeContract`, ethers, wallet-rpc, MPC,\n * Safe transactions, etc.).\n *\n * @category Protocol\n */\nimport { encodeFunctionData } from \"viem\";\nimport type { DataPortabilityGatewayConfig } from \"./eip712\";\n\n// ABI for the two deposit entry points on DataPortabilityEscrow. Same shape\n// the gateway uses to decode pending/mined tx calldata at\n// /v1/escrow/deposit time (data-gateway/lib/escrow.ts:39).\nexport const ESCROW_DEPOSIT_ABI = [\n  {\n    type: \"function\",\n    name: \"depositNative\",\n    stateMutability: \"payable\",\n    inputs: [{ name: \"account\", type: \"address\" }],\n    outputs: [],\n  },\n  {\n    type: \"function\",\n    name: \"depositToken\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      { name: \"account\", type: \"address\" },\n      { name: \"token\", type: \"address\" },\n      { name: \"amount\", type: \"uint256\" },\n    ],\n    outputs: [],\n  },\n] as const;\n\nexport function escrowContractAddress(\n  config: DataPortabilityGatewayConfig,\n): `0x${string}` {\n  return config.contracts.dataPortabilityEscrow as `0x${string}`;\n}\n\nexport interface DepositNativeInput {\n  // Address credited inside the escrow. Often the same as the wallet sending\n  // the tx, but third-party funding is supported.\n  account: `0x${string}`;\n  amount: bigint;\n}\n\nexport interface DepositTokenInput {\n  account: `0x${string}`;\n  // ERC-20 contract address.\n  token: `0x${string}`;\n  amount: bigint;\n}\n\n// Shape compatible with viem's `sendTransaction` / `writeContract` request\n// objects. `value` is omitted on the ERC-20 path because the amount lives in\n// the token contract, not `msg.value`.\nexport interface DepositTransactionRequest {\n  to: `0x${string}`;\n  data: `0x${string}`;\n  value?: bigint;\n}\n\nexport function encodeDepositNativeData(input: {\n  account: `0x${string}`;\n}): `0x${string}` {\n  return encodeFunctionData({\n    abi: ESCROW_DEPOSIT_ABI,\n    functionName: \"depositNative\",\n    args: [input.account],\n  });\n}\n\nexport function encodeDepositTokenData(\n  input: DepositTokenInput,\n): `0x${string}` {\n  return encodeFunctionData({\n    abi: ESCROW_DEPOSIT_ABI,\n    functionName: \"depositToken\",\n    args: [input.account, input.token, input.amount],\n  });\n}\n\n// Build the full tx request for a native-VANA deposit. Feed it straight to\n// `walletClient.sendTransaction({...req, account, chain})`. ERC-20 needs a\n// prior `approve(escrow, amount)` on the token — use viem's built-in\n// `erc20Abi` for that; the SDK doesn't bundle one to avoid the import surface.\nexport function buildDepositNativeRequest(\n  config: DataPortabilityGatewayConfig,\n  input: DepositNativeInput,\n): DepositTransactionRequest {\n  return {\n    to: escrowContractAddress(config),\n    data: encodeDepositNativeData({ account: input.account }),\n    value: input.amount,\n  };\n}\n\nexport function buildDepositTokenRequest(\n  config: DataPortabilityGatewayConfig,\n  input: DepositTokenInput,\n): DepositTransactionRequest {\n  return {\n    to: escrowContractAddress(config),\n    data: encodeDepositTokenData(input),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBA,kBAAmC;AAM5B,MAAM,qBAAqB;AAAA,EAChC;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,iBAAiB;AAAA,IACjB,QAAQ,CAAC,EAAE,MAAM,WAAW,MAAM,UAAU,CAAC;AAAA,IAC7C,SAAS,CAAC;AAAA,EACZ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,iBAAiB;AAAA,IACjB,QAAQ;AAAA,MACN,EAAE,MAAM,WAAW,MAAM,UAAU;AAAA,MACnC,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,MACjC,EAAE,MAAM,UAAU,MAAM,UAAU;AAAA,IACpC;AAAA,IACA,SAAS,CAAC;AAAA,EACZ;AACF;AAEO,SAAS,sBACd,QACe;AACf,SAAO,OAAO,UAAU;AAC1B;AAyBO,SAAS,wBAAwB,OAEtB;AAChB,aAAO,gCAAmB;AAAA,IACxB,KAAK;AAAA,IACL,cAAc;AAAA,IACd,MAAM,CAAC,MAAM,OAAO;AAAA,EACtB,CAAC;AACH;AAEO,SAAS,uBACd,OACe;AACf,aAAO,gCAAmB;AAAA,IACxB,KAAK;AAAA,IACL,cAAc;AAAA,IACd,MAAM,CAAC,MAAM,SAAS,MAAM,OAAO,MAAM,MAAM;AAAA,EACjD,CAAC;AACH;AAMO,SAAS,0BACd,QACA,OAC2B;AAC3B,SAAO;AAAA,IACL,IAAI,sBAAsB,MAAM;AAAA,IAChC,MAAM,wBAAwB,EAAE,SAAS,MAAM,QAAQ,CAAC;AAAA,IACxD,OAAO,MAAM;AAAA,EACf;AACF;AAEO,SAAS,yBACd,QACA,OAC2B;AAC3B,SAAO;AAAA,IACL,IAAI,sBAAsB,MAAM;AAAA,IAChC,MAAM,uBAAuB,KAAK;AAAA,EACpC;AACF;","names":[]}

package/dist/protocol/escrow-deposit.d.ts

@@ -0,0 +1,47 @@
+import type { DataPortabilityGatewayConfig } from "./eip712";
+export declare const ESCROW_DEPOSIT_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "depositNative";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "depositToken";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}];
+export declare function escrowContractAddress(config: DataPortabilityGatewayConfig): `0x${string}`;
+export interface DepositNativeInput {
+    account: `0x${string}`;
+    amount: bigint;
+}
+export interface DepositTokenInput {
+    account: `0x${string}`;
+    token: `0x${string}`;
+    amount: bigint;
+}
+export interface DepositTransactionRequest {
+    to: `0x${string}`;
+    data: `0x${string}`;
+    value?: bigint;
+}
+export declare function encodeDepositNativeData(input: {
+    account: `0x${string}`;
+}): `0x${string}`;
+export declare function encodeDepositTokenData(input: DepositTokenInput): `0x${string}`;
+export declare function buildDepositNativeRequest(config: DataPortabilityGatewayConfig, input: DepositNativeInput): DepositTransactionRequest;
+export declare function buildDepositTokenRequest(config: DataPortabilityGatewayConfig, input: DepositTokenInput): DepositTransactionRequest;

package/dist/protocol/escrow-deposit.js

@@ -0,0 +1,60 @@
+import { encodeFunctionData } from "viem";
+const 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: []
+  }
+];
+function escrowContractAddress(config) {
+  return config.contracts.dataPortabilityEscrow;
+}
+function encodeDepositNativeData(input) {
+  return encodeFunctionData({
+    abi: ESCROW_DEPOSIT_ABI,
+    functionName: "depositNative",
+    args: [input.account]
+  });
+}
+function encodeDepositTokenData(input) {
+  return encodeFunctionData({
+    abi: ESCROW_DEPOSIT_ABI,
+    functionName: "depositToken",
+    args: [input.account, input.token, input.amount]
+  });
+}
+function buildDepositNativeRequest(config, input) {
+  return {
+    to: escrowContractAddress(config),
+    data: encodeDepositNativeData({ account: input.account }),
+    value: input.amount
+  };
+}
+function buildDepositTokenRequest(config, input) {
+  return {
+    to: escrowContractAddress(config),
+    data: encodeDepositTokenData(input)
+  };
+}
+export {
+  ESCROW_DEPOSIT_ABI,
+  buildDepositNativeRequest,
+  buildDepositTokenRequest,
+  encodeDepositNativeData,
+  encodeDepositTokenData,
+  escrowContractAddress
+};
+//# sourceMappingURL=escrow-deposit.js.map

package/dist/protocol/escrow-deposit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/escrow-deposit.ts"],"sourcesContent":["/**\n * On-chain deposit primitives for the DataPortabilityEscrow contract.\n *\n * The escrow holds the finalized balance that `/v1/escrow/pay` debits against.\n * A payer credits their balance by sending one of two function calls to the\n * escrow contract — depositNative (native VANA, amount via `msg.value`) or\n * depositToken (ERC-20, caller must `approve` the escrow first). The credited\n * `account` need not equal `msg.sender`, so a third party can fund someone\n * else's escrow.\n *\n * Once the on-chain tx lands, call `GatewayClient.submitEscrowDeposit({txHash})`\n * to announce it; the gateway reconciles it into the balance and surfaces it\n * under `getEscrowBalance(account).deposits.finalized`.\n *\n * These helpers are signer/transport-agnostic — they return the raw\n * `{to, data, value?}` request object so callers can feed it to any wallet\n * stack (viem `sendTransaction`/`writeContract`, ethers, wallet-rpc, MPC,\n * Safe transactions, etc.).\n *\n * @category Protocol\n */\nimport { encodeFunctionData } from \"viem\";\nimport type { DataPortabilityGatewayConfig } from \"./eip712\";\n\n// ABI for the two deposit entry points on DataPortabilityEscrow. Same shape\n// the gateway uses to decode pending/mined tx calldata at\n// /v1/escrow/deposit time (data-gateway/lib/escrow.ts:39).\nexport const ESCROW_DEPOSIT_ABI = [\n  {\n    type: \"function\",\n    name: \"depositNative\",\n    stateMutability: \"payable\",\n    inputs: [{ name: \"account\", type: \"address\" }],\n    outputs: [],\n  },\n  {\n    type: \"function\",\n    name: \"depositToken\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      { name: \"account\", type: \"address\" },\n      { name: \"token\", type: \"address\" },\n      { name: \"amount\", type: \"uint256\" },\n    ],\n    outputs: [],\n  },\n] as const;\n\nexport function escrowContractAddress(\n  config: DataPortabilityGatewayConfig,\n): `0x${string}` {\n  return config.contracts.dataPortabilityEscrow as `0x${string}`;\n}\n\nexport interface DepositNativeInput {\n  // Address credited inside the escrow. Often the same as the wallet sending\n  // the tx, but third-party funding is supported.\n  account: `0x${string}`;\n  amount: bigint;\n}\n\nexport interface DepositTokenInput {\n  account: `0x${string}`;\n  // ERC-20 contract address.\n  token: `0x${string}`;\n  amount: bigint;\n}\n\n// Shape compatible with viem's `sendTransaction` / `writeContract` request\n// objects. `value` is omitted on the ERC-20 path because the amount lives in\n// the token contract, not `msg.value`.\nexport interface DepositTransactionRequest {\n  to: `0x${string}`;\n  data: `0x${string}`;\n  value?: bigint;\n}\n\nexport function encodeDepositNativeData(input: {\n  account: `0x${string}`;\n}): `0x${string}` {\n  return encodeFunctionData({\n    abi: ESCROW_DEPOSIT_ABI,\n    functionName: \"depositNative\",\n    args: [input.account],\n  });\n}\n\nexport function encodeDepositTokenData(\n  input: DepositTokenInput,\n): `0x${string}` {\n  return encodeFunctionData({\n    abi: ESCROW_DEPOSIT_ABI,\n    functionName: \"depositToken\",\n    args: [input.account, input.token, input.amount],\n  });\n}\n\n// Build the full tx request for a native-VANA deposit. Feed it straight to\n// `walletClient.sendTransaction({...req, account, chain})`. ERC-20 needs a\n// prior `approve(escrow, amount)` on the token — use viem's built-in\n// `erc20Abi` for that; the SDK doesn't bundle one to avoid the import surface.\nexport function buildDepositNativeRequest(\n  config: DataPortabilityGatewayConfig,\n  input: DepositNativeInput,\n): DepositTransactionRequest {\n  return {\n    to: escrowContractAddress(config),\n    data: encodeDepositNativeData({ account: input.account }),\n    value: input.amount,\n  };\n}\n\nexport function buildDepositTokenRequest(\n  config: DataPortabilityGatewayConfig,\n  input: DepositTokenInput,\n): DepositTransactionRequest {\n  return {\n    to: escrowContractAddress(config),\n    data: encodeDepositTokenData(input),\n  };\n}\n"],"mappings":"AAqBA,SAAS,0BAA0B;AAM5B,MAAM,qBAAqB;AAAA,EAChC;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,iBAAiB;AAAA,IACjB,QAAQ,CAAC,EAAE,MAAM,WAAW,MAAM,UAAU,CAAC;AAAA,IAC7C,SAAS,CAAC;AAAA,EACZ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,iBAAiB;AAAA,IACjB,QAAQ;AAAA,MACN,EAAE,MAAM,WAAW,MAAM,UAAU;AAAA,MACnC,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,MACjC,EAAE,MAAM,UAAU,MAAM,UAAU;AAAA,IACpC;AAAA,IACA,SAAS,CAAC;AAAA,EACZ;AACF;AAEO,SAAS,sBACd,QACe;AACf,SAAO,OAAO,UAAU;AAC1B;AAyBO,SAAS,wBAAwB,OAEtB;AAChB,SAAO,mBAAmB;AAAA,IACxB,KAAK;AAAA,IACL,cAAc;AAAA,IACd,MAAM,CAAC,MAAM,OAAO;AAAA,EACtB,CAAC;AACH;AAEO,SAAS,uBACd,OACe;AACf,SAAO,mBAAmB;AAAA,IACxB,KAAK;AAAA,IACL,cAAc;AAAA,IACd,MAAM,CAAC,MAAM,SAAS,MAAM,OAAO,MAAM,MAAM;AAAA,EACjD,CAAC;AACH;AAMO,SAAS,0BACd,QACA,OAC2B;AAC3B,SAAO;AAAA,IACL,IAAI,sBAAsB,MAAM;AAAA,IAChC,MAAM,wBAAwB,EAAE,SAAS,MAAM,QAAQ,CAAC;AAAA,IACxD,OAAO,MAAM;AAAA,EACf;AACF;AAEO,SAAS,yBACd,QACA,OAC2B;AAC3B,SAAO;AAAA,IACL,IAAI,sBAAsB,MAAM;AAAA,IAChC,MAAM,uBAAuB,KAAK;AAAA,EACpC;AACF;","names":[]}

package/dist/protocol/escrow-deposit.test.d.ts

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

package/dist/protocol/escrow-flow.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * End-to-end test of the deposit + payment flow.
+ *
+ * The SDK is signer- and transport-agnostic. To prove the helpers compose
+ * correctly we wire them through:
+ *
+ *   - A real viem `WalletClient` against an in-memory L1 (a custom RPC
+ *     transport routes JSON-RPC calls to a Map-backed chain). The wallet
+ *     genuinely signs an EIP-1559 transaction with the depositNative
+ *     calldata produced by buildDepositNativeRequest.
+ *
+ *   - A fetch-mocked gateway that decodes that same calldata via
+ *     ESCROW_DEPOSIT_ABI, credits a balance, and later recovers the
+ *     GenericPayment EIP-712 signer with viem's recoverTypedDataAddress —
+ *     same cryptographic checks the real gateway runs.
+ *
+ * Anything weaker than this (hand-rolled sendTx, hand-rolled sig recovery)
+ * would let the SDK's encoder or domain helpers drift silently. Going through
+ * viem's real wallet + sign paths is what makes this a useful e2e.
+ */
+export {};