@seedprotocol/eas 0.7.4-next.793.g6dd83dd → 0.7.5-next.850.g9ab585b

package/README.md

@@ -0,0 +1,81 @@
+# @seedprotocol/eas
+
+[![npm](https://img.shields.io/npm/v/@seedprotocol/eas.svg)](https://www.npmjs.com/package/@seedprotocol/eas)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Read-side [Ethereum Attestation Service (EAS)](https://attest.sh) client and helpers for [Seed Protocol](https://seedprotocol.io). It queries an EAS indexer (easscan GraphQL) for Seed, Version and property attestations, resolves which chain and indexer to read from, ships known EAS deployments per chain, and decodes Seed Protocol sidecar attestations (PublishedBy, PublishAuthorization, DomainOwnership). It does not write to chain; attesting and revoking live in `@seedprotocol/publish`.
+
+This is a lean building block. [`@seedprotocol/sdk`](https://www.npmjs.com/package/@seedprotocol/sdk) depends on it and registers the platform clients during init, so **app developers should use the SDK**. Install this package directly for servers, scripts or tools (feeds, indexers, verifiers) that read Seed attestations without the full SDK.
+
+## Installation
+
+```bash
+npm install @seedprotocol/eas
+# or
+bun add @seedprotocol/eas
+```
+
+## Usage
+
+The read helpers go through two process-wide clients (`EasClient` for GraphQL, `BaseQueryClient` for request de-duplication) that need a platform implementation. In Node.js, import the `/node` subpath, which registers both on import (`registerNodeEasPlatform()` does the same explicitly):
+
+```ts
+import '@seedprotocol/eas/node'
+import {
+  getSeedsBySchemaName,
+  getItemVersionsFromEas,
+  getCanonicalItemPropertiesFromEas,
+} from '@seedprotocol/eas'
+
+// Newest seeds for an EAS schema name, revoked ones excluded
+const seeds = await getSeedsBySchemaName('post', 20)
+
+// Versions of those seeds, then the newest live property attestation per (version, schema)
+const versions = await getItemVersionsFromEas({ seedUids: seeds.map((s) => s.id) })
+const properties = await getCanonicalItemPropertiesFromEas({
+  versionUids: versions.map((v) => v.id),
+})
+```
+
+Revoked attestations are excluded by default (`excludeRevoked: true`). See [ATTESTATION_REVOCATION.md](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/docs/ATTESTATION_REVOCATION.md).
+
+### Choosing the chain
+
+Reads default to Optimism Sepolia (`11155420`). Without SDK or publish config, set the chain with `EAS_CHAIN_ID` (or `NEXT_PUBLIC_EAS_CHAIN_ID`); override the indexer with `EAS_ENDPOINT` / `NEXT_PUBLIC_EAS_ENDPOINT`. The SDK and `@seedprotocol/publish` set it through `configureEasReadChain`, and a conflicting chain id throws rather than reading one chain while writing another.
+
+```ts
+import { getEasReadChainId, getEasEndpoint, getEasChainDeployment } from '@seedprotocol/eas'
+
+getEasReadChainId()           // e.g. 8453 when EAS_CHAIN_ID=8453
+getEasEndpoint()              // https://base.easscan.org/graphql
+getEasChainDeployment(8453)   // { name: 'Base', easContractAddress, indexerUrl, explorerUrl, ... }
+```
+
+## Exports
+
+| Entry | Main exports |
+|-------|--------------|
+| `@seedprotocol/eas` | Seeds / Versions / properties: `getSeedsBySchemaName`, `getSeedsByUidsFromEas`, `getSeedsFromSchemaUids`, `getSeedUidsBySchemaName`, `getItemVersionsFromEas`, `getItemPropertiesFromEas`, `getCanonicalItemPropertiesFromEas`, `getAttestationChangesSince` |
+| | Schemas: `getEasSchemaUidBySchemaName`, `fetchEasSchemaUidBySchemaName`, `getSchemaNamesBySchemaUids`, schema UID cache (`cachedSchemaLookup`, `getEasSchemaUidForSchemaDefinition`, `setSchemaUidForModel`, …) |
+| | Chain config: `configureEasReadChain`, `getEasReadChainId`, `getEasEndpoint`, `whenEasReadChainSettled`, `EAS_CHAIN_DEPLOYMENTS`, `DEFAULT_EAS_CHAIN_ID`, `getEasChainDeployment`, `resolveEasChainDeployment`, `getEasAttestationExplorerUrl` |
+| | Canonicalization / filters: `pickLatestPropertyAttestationsByRefAndSchema`, `withExcludeRevokedFilter`, `isValidEasAttestationUid`, `normalizeBytes32Hex` |
+| | Sidecars: `getPublishedByFromEas`, `decodePublishedByData`, `verifyPublishedByBatch`; `getPublishAuthorizationFromEas`, `assessPublishAuthorization`; `getDomainOwnershipFromEas`, `assessDomainOwnership`, plus their `*_SCHEMA_NAME` / `*_SCHEMA_DEF` constants |
+| | Clients: `EasClient` / `BaseEasClient`, `BaseQueryClient`, `IEasClient`, `IQueryClient`; GraphQL documents (`GET_SEEDS`, `GET_VERSIONS`, `GET_PROPERTIES`, …); types `Attestation`, `EASSchema` |
+| `@seedprotocol/eas/node` | `registerNodeEasPlatform()`, `NodeEasClient`, `NodeQueryClient` (a `@tanstack/query-core` client: concurrent identical requests share one fetch) |
+
+Sidecar details: [PUBLISHING.md](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/docs/PUBLISHING.md) (PublishedBy), [PUBLISH_AUTOMATION.md](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/docs/PUBLISH_AUTOMATION.md) (PublishAuthorization), [DOMAIN_OWNERSHIP.md](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/docs/DOMAIN_OWNERSHIP.md).
+
+## Related packages
+
+- [`@seedprotocol/sdk`](https://www.npmjs.com/package/@seedprotocol/sdk) — the full local-first SDK (uses this package for EAS sync)
+- [`@seedprotocol/query`](https://www.npmjs.com/package/@seedprotocol/query) — assembled Seed JSON (`getSeed`, `queryBySchema`) built on these reads
+- [`@seedprotocol/arweave`](https://www.npmjs.com/package/@seedprotocol/arweave) — Arweave gateway client
+
+## Documentation
+
+- [seedprotocol.io](https://seedprotocol.io)
+- [Changelog](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/packages/eas/CHANGELOG.md)
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -9,13 +9,18 @@ export declare const getItemPropertiesFromEas: ({ versionUids, excludeRevoked, }
     excludeRevoked?: boolean;
 }) => Promise<Attestation[]>;
 /**
- * Canonical properties of the given versions. It doesn't check attesters: filter `getItemPropertiesFromEas`
- * results with `keepAttestationsFromRefAttester(properties, versions)` first when the versions may
- * not all be trusted (see easRefAttester.ts).
+ * Canonical properties of the given versions: the newest per version and property schema.
+ *
+ * By default only attestations from the right accounts count (easRefAttester.ts): a version must
+ * be attested by its seed's attester, and a property by its version's. Anyone can attest with any
+ * refUID, so without this another account's newer property would win. That costs two more
+ * requests (the versions and their seeds); pass `checkAttesters: false` when the versions are
+ * already known to be trusted.
  */
-export declare const getCanonicalItemPropertiesFromEas: (props: {
+export declare const getCanonicalItemPropertiesFromEas: ({ versionUids, excludeRevoked, checkAttesters, }: {
     versionUids: string[];
     excludeRevoked?: boolean;
+    checkAttesters?: boolean;
 }) => Promise<Attestation[]>;
 /**
  * UID of the first EAS schema whose definition ends with `schemaName`, or undefined when there is

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,0BAA0B,CAAA;AAEhF,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEhF,eAAO,MAAM,sBAAsB,GAAU,+BAG1C;IACD,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,OAAO,CAAC,WAAW,EAAE,CAiBxB,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAU,kCAG5C;IACD,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,OAAO,CAAC,WAAW,EAAE,CAiBxB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAAU,OAAO;IAC7D,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,OAAO,CAAC,WAAW,EAAE,CAGxB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAU,iBAEjD;IACD,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAyB7B,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAU,iBAE/C;IACD,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAS7B,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAU,4CAI1C;IACD,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,2BAsCA,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,MAAM,EAClB,QAAO,MAAW,EAClB,OAAO,MAAM,EACb,UAAU;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,2BAiCjC,CAAA;AAkBD,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,QAAO,IAExC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,YAAY,MAAM,EAAE,KACnB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA6B/B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAU,2BAGzC;IACD,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,OAAO,CAAC,WAAW,EAAE,CAcxB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAKD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAU,0BAI9C;IACD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd,KAAG,OAAO,CAAC,iBAAiB,EAAE,CA8B9B,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAU,YAAY,MAAM,EAAE,QAAO,MAAW,sBAGnF,CAAA"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,0BAA0B,CAAA;AAEhF,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEhF,eAAO,MAAM,sBAAsB,GAAU,+BAG1C;IACD,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,OAAO,CAAC,WAAW,EAAE,CAiBxB,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAU,kCAG5C;IACD,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,OAAO,CAAC,WAAW,EAAE,CAiBxB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAAU,kDAIrD;IACD,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,OAAO,CAAC,WAAW,EAAE,CA6BxB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAU,iBAEjD;IACD,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAyB7B,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAU,iBAE/C;IACD,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAS7B,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAU,4CAI1C;IACD,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,2BAsCA,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,MAAM,EAClB,QAAO,MAAW,EAClB,OAAO,MAAM,EACb,UAAU;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,2BAiCjC,CAAA;AAkBD,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,QAAO,IAExC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,YAAY,MAAM,EAAE,KACnB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA6B/B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAU,2BAGzC;IACD,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,OAAO,CAAC,WAAW,EAAE,CAcxB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAKD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAU,0BAI9C;IACD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd,KAAG,OAAO,CAAC,iBAAiB,EAAE,CA8B9B,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAU,YAAY,MAAM,EAAE,QAAO,MAAW,sBAGnF,CAAA"}

package/dist/easNames.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Names on EAS (ADR 0008).
+ *
+ * Writing: {@link easName} is the only function that turns a local model or property name into an
+ * EAS name (`HTMLPage` → `html_page`). Everything that registers, attests or looks up a schema by
+ * name uses it.
+ *
+ * Reading: an EAS name is never turned back into a local name. It is matched against the local
+ * candidates by key, at a {@link NameMatchLevel}:
+ *
+ * - `exact`: the EAS name is exactly `easName(local)`, what this SDK publishes.
+ * - `normalized`: lowercase alphanumerics only. `html_page`, `htmlpage`, `HTMLPage` and
+ *   `html-page` are the same; this finds seeds published under older SDKs' names.
+ * - `fuzzy`: the normalized key without a trailing plural `s`, and for relations without a
+ *   trailing `id`/`ids`. `posts` matches `post`, `author_id` matches the relation `author`.
+ *   No edit distance: `title` never matches `tile`.
+ *
+ * The tightest tier wins; a tie in the best tier matches nothing.
+ */
+/**
+ * The EAS name of a local model or property name: words split at lowercase-or-digit to uppercase
+ * boundaries and before the last capital of an acronym, every other run of non-alphanumerics
+ * turned into `_`, trimmed, lowercased.
+ * `HTMLPage → html_page`, `ID3Tag → id3_tag`, `imageV2 → image_v2`, `New model → new_model`.
+ */
+export declare const easName: (name: string) => string;
+export type NameMatchLevel = 'exact' | 'normalized' | 'fuzzy';
+/** The levels, tightest first. */
+export declare const NAME_MATCH_LEVELS: readonly NameMatchLevel[];
+export declare const isNameMatchLevel: (value: unknown) => value is NameMatchLevel;
+/** How closely two names matched: the tightest level that accepts them. */
+export type NameMatchTier = NameMatchLevel;
+/** The default level (ADR 0008 and the nameMatch design): fuzzy. */
+export declare const DEFAULT_NAME_MATCH_LEVEL: NameMatchLevel;
+/** Lowercase alphanumerics only. */
+export declare const normalizedNameKey: (name: string) => string;
+/**
+ * The normalized key without a relation's trailing `ids`/`id` (when `relation`), then without a
+ * trailing plural `s`. Short keys are left alone, so `ids` and `bus` stay themselves.
+ */
+export declare const fuzzyNameKey: (name: string, options?: {
+    relation?: boolean;
+}) => string;
+/**
+ * The tightest tier at which a local name and a name from EAS match, or undefined. `relation`
+ * says whether the local name is a relation (Relation, Image, File, Html, or a List of them).
+ */
+export declare function nameMatchTier(localName: string, name: string, options?: {
+    relation?: boolean;
+}): NameMatchTier | undefined;
+export declare const isNameMatchAllowed: (tier: NameMatchTier, level: NameMatchLevel) => boolean;
+export declare const compareNameMatchTiers: (a: NameMatchTier, b: NameMatchTier) => number;
+export type NameMatchCandidate<T> = {
+    value: T;
+    /** The local name as it is written to EAS (a list relation's storage name, for instance). */
+    name: string;
+    relation?: boolean;
+    /** This candidate's level. Default {@link DEFAULT_NAME_MATCH_LEVEL}. */
+    level?: NameMatchLevel;
+};
+export type NameMatchResult<T> = {
+    kind: 'match';
+    value: T;
+    tier: NameMatchTier;
+} | {
+    kind: 'ambiguous';
+    values: T[];
+    tier: NameMatchTier;
+} | {
+    kind: 'none';
+};
+/**
+ * The candidate an EAS name matches: the one in the tightest tier its own level allows. Several
+ * candidates in that tier are ambiguous, and match nothing.
+ */
+export declare function matchEasName<T>(name: string, candidates: readonly NameMatchCandidate<T>[]): NameMatchResult<T>;
+/**
+ * The local names an EAS name matches in the tightest tier that has any (each name at `level`, or
+ * at the level `level(localName)` returns). Several names can share a tier, e.g. `New model` and
+ * `NewModel` for `new_model`: the caller decides whether that's ambiguous (models in different
+ * schemas) or the same thing.
+ */
+export declare function localNamesInBestMatchTier(name: string, localNames: Iterable<string>, options?: {
+    relation?: boolean;
+    level?: NameMatchLevel | ((localName: string) => NameMatchLevel);
+}): Set<string>;
+/**
+ * Names that can match `name` at the normalized level and that an SDK may have written: its EAS
+ * name, and what older SDKs published (the simple snake_case: `HTMLPage` → `htmlpage`). For
+ * fetching schemas by name; the results are then filtered with {@link matchEasName}.
+ */
+export declare function easNameVariants(name: string): string[];
+/**
+ * The EAS names to fetch schemas under for a local model name at `level`: at `exact` its EAS name
+ * only; at `normalized` also {@link easNameVariants} and the name as written; at `fuzzy` also a
+ * plural or singular form of each. Fetching is a superset: results are still filtered with
+ * {@link matchEasName}.
+ */
+export declare function easNamesToFetch(name: string, level?: NameMatchLevel): string[];
+//# sourceMappingURL=easNames.d.ts.map

package/dist/easNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easNames.d.ts","sourceRoot":"","sources":["../src/easNames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,MAMrB,CAAA;AAElB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAAA;AAE7D,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAAqC,CAAA;AAE5F,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAC4B,CAAA;AAEvF,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,cAAc,CAAA;AAI1C,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,EAAE,cAAwB,CAAA;AAE/D,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MAAsD,CAAA;AAEvG;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,UAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,KAAG,MAQjF,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,aAAa,GAAG,SAAS,CAK3B;AAED,eAAO,MAAM,kBAAkB,GAAI,MAAM,aAAa,EAAE,OAAO,cAAc,KAAG,OAC3C,CAAA;AAErC,eAAO,MAAM,qBAAqB,GAAI,GAAG,aAAa,EAAE,GAAG,aAAa,KAAG,MAC9C,CAAA;AAE7B,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAClC,KAAK,EAAE,CAAC,CAAA;IACR,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wEAAwE;IACxE,KAAK,CAAC,EAAE,cAAc,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,GAC3C,eAAe,CAAC,CAAC,CAAC,CAgBpB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,cAAc,CAAC,CAAA;CAAO,GACrG,GAAG,CAAC,MAAM,CAAC,CAkBb;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,cAAyC,GAAG,MAAM,EAAE,CAOxG"}

package/dist/easValues.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Numeric values on EAS (ADR 0010).
+ *
+ * The indexer's `decodedDataJson` gives a small uint (`uint8`) as a JSON number or a numeric
+ * string, and a wide one (`uint256`) as `{ type: 'BigNumber', hex }`. Seed publishes Number as a
+ * decimal string and Date as `uint256` Unix seconds. {@link decodeEasNumber} reads all of these.
+ */
+/** `uint8` … `uint256`, `int8` … `int256`, and the bare `uint`/`int`. */
+export declare function isNumericEasType(easType: string | undefined | null): boolean;
+/**
+ * The decimal string for a numeric EAS value, or undefined when it isn't numeric.
+ *
+ * Accepts a finite JSON number, a bigint, a decimal or `0x` hex string, and an ethers v5
+ * `{ type: 'BigNumber', hex }` (or `{ _hex }`). Integer strings stay exact (`'9007199254740993'`);
+ * other numbers come back as `String(Number(value))` (`'1.5'`, `'1e+21'`). Publish uses the same
+ * function for the value it attests, so what is written and what is read agree.
+ */
+export declare function decodeEasNumber(value: unknown): string | undefined;
+//# sourceMappingURL=easValues.d.ts.map

package/dist/easValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easValues.d.ts","sourceRoot":"","sources":["../src/easValues.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAE5E;AASD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBlE"}

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export * from './domainOwnership.js';
 export * from './publishAuthorization.js';
 export * from './easPropertyCanonical.js';
 export * from './easRefAttester.js';
+export * from './easNames.js';
+export * from './easValues.js';
 export * from './easRevokedFilter.js';
 export * from './easUid.js';
 export * from './publishedBy.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,8BAA8B,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,cAAc,kCAAkC,CAAA;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAA;AAC/E,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACpF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC5F,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAA;AACzB,cAAc,4BAA4B,CAAA;AAC1C,YAAY,EACV,WAAW,EACX,MAAM,IAAI,SAAS,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,8BAA8B,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,cAAc,kCAAkC,CAAA;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAA;AAC/E,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACpF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC5F,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAA;AACzB,cAAc,4BAA4B,CAAA;AAC1C,YAAY,EACV,WAAW,EACX,MAAM,IAAI,SAAS,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAA"}