@opendatalabs/personal-server-ts-core 0.0.1-canary.01ca694 → 0.0.1-canary.052d47e

package/dist/derivatives/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Derivative compute layer: a builder registers a QUESTION over the owner's
+ * source scopes; the Personal Server answers it locally with an inference
+ * provider and writes the answer as an ordinary derivative record (lineage
+ * = the source data points) into the derived scope. See
+ * docs/derivative-data-api.md, "Compute (question to derivative)".
+ */
+export type QuestionStatus = "pending" | "ready" | "failed" | "stale";
+/**
+ * When the answer recomputes: "on-change" follows every source change (the
+ * original behavior and the default); "snapshot" computes at registration
+ * and afterwards only on an explicit POST /questions/:id/recompute.
+ */
+export type QuestionRecompute = "snapshot" | "on-change";
+/**
+ * Closed vocabulary for the machine-readable failure class. Deliberately
+ * coarse: it is served to readers of the derived scope through the status
+ * route, so it must never carry a scope name, the question or provider
+ * detail. `inference_unavailable` is the one transient class (the scheduler
+ * retries it); everything else stays failed until a source change or an
+ * explicit recompute.
+ */
+export type QuestionErrorCode = "inference_unavailable" | "source_missing" | "grant_invalid" | "internal";
+/** Who registered the question; a builder is bound to the write grant. */
+export type QuestionRegisteredBy = {
+    kind: "owner";
+} | {
+    kind: "builder";
+    builder: `0x${string}`;
+    grantId: string;
+};
+export interface QuestionRegistration {
+    questionId: string;
+    derivedScope: string;
+    sourceScopes: string[];
+    /** The prompt template text (the builder's question). */
+    question: string;
+    /** Model override; null = the provider's default. */
+    model: string | null;
+    recompute: QuestionRecompute;
+    registeredBy: QuestionRegisteredBy;
+    status: QuestionStatus;
+    /** Short failure reason (never the prompt or the data). Null unless failed. */
+    error: string | null;
+    /** Machine-readable failure class; null unless failed. */
+    errorCode: QuestionErrorCode | null;
+    createdAt: string;
+    updatedAt: string;
+    lastComputedAt: string | null;
+    /** Local index version of the derived record the last compute wrote. */
+    derivedVersion: number | null;
+    derivedCollectedAt: string | null;
+}
+export type QuestionRegistrationPatch = Partial<Pick<QuestionRegistration, "status" | "error" | "errorCode" | "updatedAt" | "lastComputedAt" | "derivedVersion" | "derivedCollectedAt">>;
+export interface QuestionStoreListFilter {
+    derivedScope?: string;
+    sourceScope?: string;
+    builder?: `0x${string}`;
+}
+/**
+ * Persistence for question registrations. Small and local: registrations
+ * never sync (the replica that holds them computes them). Implementations:
+ * sqlite (server), a state-store backed map (PS-Lite), in-memory (tests).
+ */
+export interface QuestionStore {
+    list(filter?: QuestionStoreListFilter): Promise<QuestionRegistration[]>;
+    get(questionId: string): Promise<QuestionRegistration | null>;
+    insert(registration: QuestionRegistration): Promise<void>;
+    /** Returns the updated row, or null when the id is unknown. */
+    update(questionId: string, patch: QuestionRegistrationPatch): Promise<QuestionRegistration | null>;
+    delete(questionId: string): Promise<boolean>;
+}
+/** Public JSON shape of a registration (GET / list / POST responses). */
+export interface QuestionRegistrationView {
+    questionId: string;
+    derivedScope: string;
+    sourceScopes: string[];
+    question: string;
+    model: string | null;
+    recompute: QuestionRecompute;
+    registeredBy: QuestionRegisteredBy;
+    status: QuestionStatus;
+    error: string | null;
+    errorCode: QuestionErrorCode | null;
+    createdAt: string;
+    updatedAt: string;
+    lastComputedAt: string | null;
+    derivedVersion: number | null;
+    derivedCollectedAt: string | null;
+}
+export declare function questionRegistrationView(registration: QuestionRegistration): QuestionRegistrationView;
+//# sourceMappingURL=types.d.ts.map

package/dist/derivatives/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/derivatives/types.ts"],"names":[],"mappings":"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"}

package/dist/derivatives/types.js

@@ -0,0 +1,27 @@
+/**
+ * Derivative compute layer: a builder registers a QUESTION over the owner's
+ * source scopes; the Personal Server answers it locally with an inference
+ * provider and writes the answer as an ordinary derivative record (lineage
+ * = the source data points) into the derived scope. See
+ * docs/derivative-data-api.md, "Compute (question to derivative)".
+ */
+export function questionRegistrationView(registration) {
+    return {
+        questionId: registration.questionId,
+        derivedScope: registration.derivedScope,
+        sourceScopes: [...registration.sourceScopes],
+        question: registration.question,
+        model: registration.model,
+        recompute: registration.recompute,
+        registeredBy: registration.registeredBy,
+        status: registration.status,
+        error: registration.error,
+        errorCode: registration.errorCode,
+        createdAt: registration.createdAt,
+        updatedAt: registration.updatedAt,
+        lastComputedAt: registration.lastComputedAt,
+        derivedVersion: registration.derivedVersion,
+        derivedCollectedAt: registration.derivedCollectedAt,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/derivatives/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/derivatives/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyGH,MAAM,UAAU,wBAAwB,CACtC,YAAkC;IAElC,OAAO;QACL,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC;QAC5C,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,cAAc,EAAE,YAAY,CAAC,cAAc;QAC3C,cAAc,EAAE,YAAY,CAAC,cAAc;QAC3C,kBAAkB,EAAE,YAAY,CAAC,kBAAkB;KACpD,CAAC;AACJ,CAAC"}

package/dist/errors/catalog.d.ts

@@ -35,6 +35,9 @@ export declare class GrantRevokedError extends ProtocolError {
 export declare class ScopeMismatchError extends ProtocolError {
     constructor(details?: Record<string, unknown>);
 }
+export declare class GrantOwnerMismatchError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
 export declare class FeeRequiredError extends ProtocolError {
     constructor(details?: Record<string, unknown>);
 }
@@ -44,7 +47,79 @@ export declare class PsUnavailableError extends ProtocolError {
 export declare class ServerNotConfiguredError extends ProtocolError {
     constructor(details?: Record<string, unknown>);
 }
+export declare class SignedArtifactMissingError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class SignedArtifactInvalidError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class ServerSigningUnavailableError extends ProtocolError {
+    constructor();
+}
 export declare class ContentTooLargeError extends ProtocolError {
     constructor(details?: Record<string, unknown>);
 }
+export declare class LineageInvalidError extends ProtocolError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class LineageScopeUnderSourcePrefixError extends ProtocolError {
+    constructor(details: {
+        scope: string;
+        sourceScope: string;
+    });
+}
+export declare class LineageSourceUnknownError extends ProtocolError {
+    constructor(details: {
+        unknown: string[];
+    });
+}
+export declare class LineageSourceLookupFailedError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class LineageUnavailableError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class LineageGatewayError extends ProtocolError {
+    constructor(details: {
+        status: number;
+        body: unknown;
+    });
+}
+export declare class LineageCascadeUnavailableError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class InvalidCascadeError extends ProtocolError {
+    constructor(details: {
+        cascade: string;
+    });
+}
+export declare class DeleteTombstoneFailedError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class DataDeletedError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class DerivativeQuestionInvalidError extends ProtocolError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class DerivativeQuestionNotFoundError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class DerivativeDerivedScopeRequiredError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
+export declare class DerivativeCycleError extends ProtocolError {
+    constructor(details: {
+        derivedScope: string;
+        path: string[];
+    });
+}
+export declare class DerivativeSourceNotGrantedError extends ProtocolError {
+    constructor(details: {
+        scopes: string[];
+    });
+}
+export declare class DerivativeComputeUnavailableError extends ProtocolError {
+    constructor(details?: Record<string, unknown>);
+}
 //# sourceMappingURL=catalog.d.ts.map

package/dist/errors/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/errors/catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;aAEjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAMnD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlC;AAID,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAID,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQ9C;AAED,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C;AAID,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG9C"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/errors/catalog.ts"],"names":[],"mappings":"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"}

package/dist/errors/catalog.js

@@ -70,6 +70,11 @@ export class ScopeMismatchError extends ProtocolError {
         super(403, "SCOPE_MISMATCH", "Scope not granted", details);
     }
 }
+export class GrantOwnerMismatchError extends ProtocolError {
+    constructor(details) {
+        super(403, "GRANT_OWNER_MISMATCH", "Grant was not issued by this server's owner", details);
+    }
+}
 export class FeeRequiredError extends ProtocolError {
     constructor(details) {
         super(403, "FEE_REQUIRED", "Required fee has not been paid", details);
@@ -85,10 +90,109 @@ export class ServerNotConfiguredError extends ProtocolError {
         super(500, "SERVER_NOT_CONFIGURED", "Server is not configured", details);
     }
 }
+export class SignedArtifactMissingError extends ProtocolError {
+    constructor(details) {
+        super(403, "SIGNED_ARTIFACT_MISSING", "Signed artifact is missing", details);
+    }
+}
+export class SignedArtifactInvalidError extends ProtocolError {
+    constructor(details) {
+        super(403, "SIGNED_ARTIFACT_INVALID", "Signed artifact is invalid", details);
+    }
+}
+export class ServerSigningUnavailableError extends ProtocolError {
+    constructor() {
+        super(500, "SERVER_SIGNING_UNAVAILABLE", "Server signing is unavailable in this runtime");
+    }
+}
 // 413 — Payload errors
 export class ContentTooLargeError extends ProtocolError {
     constructor(details) {
         super(413, "CONTENT_TOO_LARGE", "Content too large", details);
     }
 }
+// Derivative data / lineage (see docs/derivative-data-api.md)
+export class LineageInvalidError extends ProtocolError {
+    constructor(message, details) {
+        super(400, "LINEAGE_INVALID", message, details);
+    }
+}
+export class LineageScopeUnderSourcePrefixError extends ProtocolError {
+    constructor(details) {
+        super(400, "LINEAGE_SCOPE_UNDER_SOURCE_PREFIX", `Derived scope "${details.scope}" shares its first segment with source scope "${details.sourceScope}"; a wildcard grant on that namespace would read both. Name derivatives under their own namespace.`, details);
+    }
+}
+export class LineageSourceUnknownError extends ProtocolError {
+    constructor(details) {
+        super(422, "LINEAGE_SOURCE_UNKNOWN", "One or more lineage sources are not data points of this owner", details);
+    }
+}
+export class LineageSourceLookupFailedError extends ProtocolError {
+    constructor(details) {
+        super(502, "LINEAGE_SOURCE_LOOKUP_FAILED", "Could not resolve a lineage source at the gateway", details);
+    }
+}
+export class LineageUnavailableError extends ProtocolError {
+    constructor(details) {
+        super(503, "LINEAGE_UNAVAILABLE", "This server is not configured to reach the gateway lineage graph (gateway URL or server signing key missing)", details);
+    }
+}
+export class LineageGatewayError extends ProtocolError {
+    constructor(details) {
+        super(502, "LINEAGE_GATEWAY_ERROR", `Gateway lineage request failed with status ${details.status}`, details);
+    }
+}
+export class LineageCascadeUnavailableError extends ProtocolError {
+    constructor(details) {
+        super(501, "LINEAGE_CASCADE_UNAVAILABLE", "DELETE ?cascade=lineage is specified but not implemented yet: the lineage walk that finds every derivative is missing. Delete scopes one at a time; each single-scope delete is durable.", details);
+    }
+}
+export class InvalidCascadeError extends ProtocolError {
+    constructor(details) {
+        super(400, "INVALID_CASCADE", 'Unsupported cascade mode; the only supported value is "lineage"', details);
+    }
+}
+// 502 - Upstream (gateway) errors
+export class DeleteTombstoneFailedError extends ProtocolError {
+    constructor(details) {
+        super(502, "DELETE_TOMBSTONE_FAILED", "Gateway did not acknowledge the deletion tombstone; nothing was deleted", details);
+    }
+}
+// 410 - Deleted resources
+export class DataDeletedError extends ProtocolError {
+    constructor(details) {
+        super(410, "DATA_DELETED", "Data point has been deleted", details);
+    }
+}
+// Derivative compute (see docs/derivative-data-api.md, "Compute")
+export class DerivativeQuestionInvalidError extends ProtocolError {
+    constructor(message, details) {
+        super(400, "DERIVATIVE_QUESTION_INVALID", message, details);
+    }
+}
+export class DerivativeQuestionNotFoundError extends ProtocolError {
+    constructor(details) {
+        super(404, "DERIVATIVE_QUESTION_NOT_FOUND", "Question not found", details);
+    }
+}
+export class DerivativeDerivedScopeRequiredError extends ProtocolError {
+    constructor(details) {
+        super(400, "DERIVATIVE_DERIVED_SCOPE_REQUIRED", "Listing questions as a builder needs a derived scope: add ?derivedScope=<scope>. The unfiltered list is the owner's", details);
+    }
+}
+export class DerivativeCycleError extends ProtocolError {
+    constructor(details) {
+        super(409, "DERIVATIVE_CYCLE", `Registering this question would make "${details.derivedScope}" a transitive source of itself; recompute would never settle`, details);
+    }
+}
+export class DerivativeSourceNotGrantedError extends ProtocolError {
+    constructor(details) {
+        super(403, "DERIVATIVE_SOURCE_NOT_GRANTED", "The builder's grant does not cover reading every source scope of this question", details);
+    }
+}
+export class DerivativeComputeUnavailableError extends ProtocolError {
+    constructor(details) {
+        super(503, "DERIVATIVE_COMPUTE_UNAVAILABLE", "This server has no derivative compute configured", details);
+    }
+}
 //# sourceMappingURL=catalog.js.map

package/dist/errors/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/errors/catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IACA;IAEA;IAJlB,YACkB,IAAY,EACZ,SAAiB,EACjC,OAAe,EACC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QACZ,cAAS,GAAT,SAAS,CAAQ;QAEjB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;aAC7D;SACF,CAAC;IACJ,CAAC;CACF;AAED,8BAA8B;AAE9B,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,mCAAmC;AAEnC,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,gCAAgC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,gBAAgB,EAChB,qCAAqC,EACrC,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;CACF;AAED,uBAAuB;AAEvB,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/errors/catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IACA;IAEA;IAJlB,YACkB,IAAY,EACZ,SAAiB,EACjC,OAAe,EACC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QACZ,cAAS,GAAT,SAAS,CAAQ;QAEjB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;aAC7D;SACF,CAAC;IACJ,CAAC;CACF;AAED,8BAA8B;AAE9B,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,mCAAmC;AAEnC,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IACxD,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,sBAAsB,EACtB,6CAA6C,EAC7C,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,gCAAgC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,gBAAgB,EAChB,qCAAqC,EACrC,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,yBAAyB,EACzB,4BAA4B,EAC5B,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,yBAAyB,EACzB,4BAA4B,EAC5B,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,6BAA8B,SAAQ,aAAa;IAC9D;QACE,KAAK,CACH,GAAG,EACH,4BAA4B,EAC5B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF;AAED,uBAAuB;AAEvB,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF;AAED,8DAA8D;AAE9D,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,kCAAmC,SAAQ,aAAa;IACnE,YAAY,OAA+C;QACzD,KAAK,CACH,GAAG,EACH,mCAAmC,EACnC,kBAAkB,OAAO,CAAC,KAAK,iDAAiD,OAAO,CAAC,WAAW,oGAAoG,EACvM,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,aAAa;IAC1D,YAAY,OAA8B;QACxC,KAAK,CACH,GAAG,EACH,wBAAwB,EACxB,+DAA+D,EAC/D,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,aAAa;IAC/D,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,8BAA8B,EAC9B,mDAAmD,EACnD,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IACxD,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,qBAAqB,EACrB,8GAA8G,EAC9G,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAA0C;QACpD,KAAK,CACH,GAAG,EACH,uBAAuB,EACvB,8CAA8C,OAAO,CAAC,MAAM,EAAE,EAC9D,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,aAAa;IAC/D,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,6BAA6B,EAC7B,0LAA0L,EAC1L,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAA4B;QACtC,KAAK,CACH,GAAG,EACH,iBAAiB,EACjB,iEAAiE,EACjE,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,kCAAkC;AAElC,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,yBAAyB,EACzB,yEAAyE,EACzE,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,0BAA0B;AAE1B,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,6BAA6B,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;CACF;AAED,kEAAkE;AAElE,MAAM,OAAO,8BAA+B,SAAQ,aAAa;IAC/D,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,GAAG,EAAE,6BAA6B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,aAAa;IAChE,YAAY,OAAiC;QAC3C,KAAK,CAAC,GAAG,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;CACF;AAED,MAAM,OAAO,mCAAoC,SAAQ,aAAa;IACpE,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,mCAAmC,EACnC,qHAAqH,EACrH,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD,YAAY,OAAiD;QAC3D,KAAK,CACH,GAAG,EACH,kBAAkB,EAClB,yCAAyC,OAAO,CAAC,YAAY,+DAA+D,EAC5H,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,aAAa;IAChE,YAAY,OAA6B;QACvC,KAAK,CACH,GAAG,EACH,+BAA+B,EAC/B,gFAAgF,EAChF,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,iCAAkC,SAAQ,aAAa;IAClE,YAAY,OAAiC;QAC3C,KAAK,CACH,GAAG,EACH,gCAAgC,EAChC,kDAAkD,EAClD,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/grants/index.d.ts

@@ -1,2 +1,3 @@
-export { GRANT_REGISTRATION_TYPES, GRANT_REVOCATION_TYPES, grantRegistrationDomain, grantRevocationDomain, isDataPortabilityGatewayConfig, parseGrantRegistrationPayload, verifyGrantRegistration, type DataPortabilityGatewayConfig, type DataPortabilityGrantPayload, type GrantRegistrationMessage, type GrantRevocationMessage, type VerifyGrantRegistrationInput, type VerifyGrantRegistrationResult, } from "@opendatalabs/vana-sdk/browser";
+export { GRANT_REGISTRATION_TYPES, GRANT_REVOCATION_TYPES, grantRegistrationDomain, grantRevocationDomain, isDataPortabilityGatewayConfig, verifyGrantRegistration, type DataPortabilityGatewayConfig, type GrantRegistrationMessage, type GrantRevocationMessage, type VerifyGrantRegistrationInput, type VerifyGrantRegistrationResult, } from "@opendatalabs/vana-sdk/browser";
+export type { GatewayGrantResponse, GatewayGrantStatus, GatewayGrantFee, GrantListItem, } from "@opendatalabs/vana-sdk/browser";
 //# sourceMappingURL=index.d.ts.map

package/dist/grants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,8BAA8B,EAC9B,6BAA6B,EAC7B,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,GACnC,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,8BAA8B,EAC9B,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,GACnC,MAAM,gCAAgC,CAAC;AAQxC,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,gCAAgC,CAAC"}

package/dist/grants/index.js

@@ -1,2 +1,2 @@
-export { GRANT_REGISTRATION_TYPES, GRANT_REVOCATION_TYPES, grantRegistrationDomain, grantRevocationDomain, isDataPortabilityGatewayConfig, parseGrantRegistrationPayload, verifyGrantRegistration, } from "@opendatalabs/vana-sdk/browser";
+export { GRANT_REGISTRATION_TYPES, GRANT_REVOCATION_TYPES, grantRegistrationDomain, grantRevocationDomain, isDataPortabilityGatewayConfig, verifyGrantRegistration, } from "@opendatalabs/vana-sdk/browser";
 //# sourceMappingURL=index.js.map

package/dist/grants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/grants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,8BAA8B,EAC9B,6BAA6B,EAC7B,uBAAuB,GAOxB,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/grants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,8BAA8B,EAC9B,uBAAuB,GAMxB,MAAM,gCAAgC,CAAC"}

package/dist/keys/index.d.ts

@@ -1,2 +1,3 @@
 export type { KeyFileData, ServerAccount, SignTypedDataParams, } from "./server-account.js";
+export { createPublicOnlyAccount, type PublicOnlyAccountInput, } from "./public-only-account.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/keys/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/keys/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/keys/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC"}

package/dist/keys/index.js

@@ -1,2 +1,2 @@
-export {};
+export { createPublicOnlyAccount, } from "./public-only-account.js";
 //# sourceMappingURL=index.js.map

package/dist/keys/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/keys/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/keys/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,uBAAuB,GAExB,MAAM,0BAA0B,CAAC"}

package/dist/keys/public-only-account.d.ts

@@ -0,0 +1,8 @@
+import { type Address, type Hex } from "viem";
+import type { ServerAccount } from "./server-account.js";
+export interface PublicOnlyAccountInput {
+    address: Address;
+    publicKey: Hex;
+}
+export declare function createPublicOnlyAccount(input: PublicOnlyAccountInput): ServerAccount;
+//# sourceMappingURL=public-only-account.d.ts.map

package/dist/keys/public-only-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-only-account.d.ts","sourceRoot":"","sources":["../../src/keys/public-only-account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,GAAG,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,aAAa,CAgBf"}

package/dist/keys/public-only-account.js

@@ -0,0 +1,21 @@
+import { isAddressEqual } from "viem";
+import { publicKeyToAddress } from "viem/accounts";
+import { ServerSigningUnavailableError } from "../errors/catalog.js";
+const KEY_MISMATCH_MESSAGE = "Public key does not match server address";
+export function createPublicOnlyAccount(input) {
+    const derivedAddress = publicKeyToAddress(input.publicKey);
+    if (!isAddressEqual(derivedAddress, input.address)) {
+        throw new Error(KEY_MISMATCH_MESSAGE);
+    }
+    return {
+        address: input.address,
+        publicKey: input.publicKey,
+        async signTypedData() {
+            throw new ServerSigningUnavailableError();
+        },
+        async signMessage() {
+            throw new ServerSigningUnavailableError();
+        },
+    };
+}
+//# sourceMappingURL=public-only-account.js.map

package/dist/keys/public-only-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-only-account.js","sourceRoot":"","sources":["../../src/keys/public-only-account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,MAAM,MAAM,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAGrE,MAAM,oBAAoB,GAAG,0CAA0C,CAAC;AAOxE,MAAM,UAAU,uBAAuB,CACrC,KAA6B;IAE7B,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,CAAC,aAAa;YACjB,MAAM,IAAI,6BAA6B,EAAE,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,WAAW;YACf,MAAM,IAAI,6BAA6B,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/keys/server-account.d.ts

@@ -1,10 +1,10 @@
 import type { TypedDataDomain } from "viem";
 export interface SignTypedDataParams {
     domain: TypedDataDomain;
-    types: Record<string, Array<{
+    types: Record<string, readonly {
         name: string;
         type: string;
-    }>>;
+    }[]>;
     primaryType: string;
     message: Record<string, unknown>;
 }

package/dist/keys/server-account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-account.d.ts","sourceRoot":"","sources":["../../src/keys/server-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IACnE,yCAAyC;IACzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"server-account.d.ts","sourceRoot":"","sources":["../../src/keys/server-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IAIxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IACnE,yCAAyC;IACzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/lineage/attestation.d.ts

@@ -0,0 +1,42 @@
+/**
+ * LineageAttestation: the server-signed statement that binds a derivative's
+ * lineage to the version it is registered with.
+ *
+ * The on-chain AddData struct is unchanged and `dataHash` (keccak256 of the
+ * plaintext envelope, `$lineage` included) already commits to the lineage.
+ * The gateway cannot open that commitment, so the plaintext source list it
+ * stores next to the registration needs its own proof of authorship: the
+ * AddData signature is public in every gateway attestation, so without one
+ * anybody could replay a registration as a same-version refresh carrying a
+ * different lineage. The attestation is EIP-712 under the DataRegistry
+ * domain (same as AddData), signed by the owner or a registered server,
+ * and bound to the exact version and dataHash so it cannot be moved to
+ * another registration either.
+ */
+export declare const LINEAGE_ATTESTATION_TYPES: {
+    readonly LineageAttestation: readonly [{
+        readonly name: "ownerAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "scope";
+        readonly type: "string";
+    }, {
+        readonly name: "expectedVersion";
+        readonly type: "uint256";
+    }, {
+        readonly name: "dataHash";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "sources";
+        readonly type: "bytes32[]";
+    }];
+};
+export interface LineageAttestationMessage {
+    ownerAddress: `0x${string}`;
+    scope: string;
+    expectedVersion: bigint;
+    dataHash: `0x${string}`;
+    /** Lowercase source data point ids in the registered order. */
+    sources: readonly `0x${string}`[];
+}
+//# sourceMappingURL=attestation.d.ts.map

package/dist/lineage/attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../../src/lineage/attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;CAQ5B,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,OAAO,EAAE,SAAS,KAAK,MAAM,EAAE,EAAE,CAAC;CACnC"}

package/dist/lineage/attestation.js

@@ -0,0 +1,25 @@
+/**
+ * LineageAttestation: the server-signed statement that binds a derivative's
+ * lineage to the version it is registered with.
+ *
+ * The on-chain AddData struct is unchanged and `dataHash` (keccak256 of the
+ * plaintext envelope, `$lineage` included) already commits to the lineage.
+ * The gateway cannot open that commitment, so the plaintext source list it
+ * stores next to the registration needs its own proof of authorship: the
+ * AddData signature is public in every gateway attestation, so without one
+ * anybody could replay a registration as a same-version refresh carrying a
+ * different lineage. The attestation is EIP-712 under the DataRegistry
+ * domain (same as AddData), signed by the owner or a registered server,
+ * and bound to the exact version and dataHash so it cannot be moved to
+ * another registration either.
+ */
+export const LINEAGE_ATTESTATION_TYPES = {
+    LineageAttestation: [
+        { name: "ownerAddress", type: "address" },
+        { name: "scope", type: "string" },
+        { name: "expectedVersion", type: "uint256" },
+        { name: "dataHash", type: "bytes32" },
+        { name: "sources", type: "bytes32[]" },
+    ],
+};
+//# sourceMappingURL=attestation.js.map

package/dist/lineage/attestation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.js","sourceRoot":"","sources":["../../src/lineage/attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,kBAAkB,EAAE;QAClB,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;QACzC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;QACjC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5C,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;QACrC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;KACvC;CACO,CAAC"}