tapimo 0.0.0 → 0.0.2

package/dist/internal/Mpp.d.ts

@@ -0,0 +1,71 @@
+import { Hex } from 'ox';
+import * as Store from './Store.js';
+/**
+ * Whether a `TransferWithMemo` memo is an MPP attribution memo: a full 32-byte
+ * value prefixed with the {@link attributionTag}.
+ */
+export declare function isAttributionMemo(memo: Hex.Hex): boolean;
+/**
+ * Extracts the 10-byte MPP server fingerprint from an attribution memo, or
+ * undefined when the memo is not an attribution memo. The fingerprint occupies
+ * bytes 5–14 (after the 4-byte tag and a 1-byte version), matching the
+ * `0x`-prefixed lowercase hex keys produced by {@link fingerprintForRealm}.
+ */
+export declare function extractFingerprint(memo: Hex.Hex): string | undefined;
+/**
+ * Computes the MPP server fingerprint for a service realm: the first 10 bytes
+ * of `keccak256(realm)`, lowercased. The directory and the memo agree on this
+ * derivation, so a memo fingerprint can be matched against the directory map.
+ */
+export declare function fingerprintForRealm(realm: string): string;
+/**
+ * Resolves the service display name for a transfer from its attribution memo:
+ * the live directory entry for the memo's fingerprint, falling back to the
+ * generic `MPP Service` label when the memo is an attribution memo whose
+ * fingerprint is not (yet) in the directory. Returns undefined when there is no
+ * attribution memo (e.g. inbound transfers reconstructed without log data, or
+ * plain non-MPP transfers).
+ */
+export declare function resolve(options: resolve.Options): string | undefined;
+export declare namespace resolve {
+    /** Options for {@link resolve}. */
+    type Options = {
+        /** Fingerprint → service-name directory map, when available. */
+        fingerprintMap?: Record<string, string> | undefined;
+        /** Raw `TransferWithMemo` memo, when the transfer carried one. */
+        memo?: Hex.Hex | undefined;
+    };
+}
+/**
+ * Fetches and memoizes the live MPP directory as a fingerprint → service-name
+ * map, so attribution memos can be resolved to current service names. The fetch
+ * is bounded by a short timeout; only successful results are cached (failures
+ * propagate so the next call retries rather than caching an empty map).
+ */
+export declare function fingerprintMap(options: fingerprintMap.Options): Promise<Record<string, string>>;
+export declare namespace fingerprintMap {
+    /** Options for {@link fingerprintMap}. */
+    type Options = {
+        /** Cache store for directory memoization. */
+        store: Store.Store;
+        /** Cache TTL in milliseconds (defaults to 10 minutes). */
+        ttl?: number | undefined;
+        /** Override for the directory endpoint (defaults to the live MPP directory). */
+        url?: string | undefined;
+    };
+    /** Shape of the MPP directory response. */
+    type Directory = {
+        services: readonly {
+            id: string;
+            name: string;
+            realm?: string | undefined;
+        }[];
+    };
+}
+/** Thrown when the MPP directory endpoint returns a non-2xx status. */
+export declare class UpstreamError extends Error {
+    /** The HTTP status returned by the directory endpoint. */
+    status: number;
+    constructor(status: number);
+}
+//# sourceMappingURL=Mpp.d.ts.map

package/dist/internal/Mpp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mpp.d.ts","sourceRoot":"","sources":["../../src/internal/Mpp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,GAAG,EAAE,MAAM,IAAI,CAAA;AAE9B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAcnC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,SAAS,CASpE;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,mCAAmC;IACnC,KAAK,OAAO,GAAG;QACb,gEAAgE;QAChE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;QACnD,kEAAkE;QAClE,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,SAAS,CAAA;KAC3B,CAAA;CACF;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,CAAC,OAAO,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA8BjC;AAED,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC,0CAA0C;IAC1C,KAAK,OAAO,GAAG;QACb,6CAA6C;QAC7C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;QAClB,0DAA0D;QAC1D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACxB,gFAAgF;QAChF,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACzB,CAAA;IACD,2CAA2C;IAC3C,KAAK,SAAS,GAAG;QACf,QAAQ,EAAE,SAAS;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,EAAE,CAAA;KAC9E,CAAA;CACF;AAED,uEAAuE;AACvE,qBAAa,aAAc,SAAQ,KAAK;IACtC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IAEd,YAAY,MAAM,EAAE,MAAM,EAIzB;CACF"}

package/dist/internal/Mpp.js

@@ -0,0 +1,105 @@
+import { Hash, Hex } from 'ox';
+import * as Store from './Store.js';
+import * as Ttl from './Ttl.js';
+/**
+ * The 4-byte tag that prefixes every MPP attribution memo. A `TransferWithMemo`
+ * whose memo starts with this tag encodes the paying service's server
+ * fingerprint rather than human-readable text, so the memo is suppressed from
+ * the UI and decoded into a service name instead.
+ */
+const attributionTag = '0xef1ed712';
+/** The live MPP service directory endpoint. */
+const directoryUrl = 'https://mpp.dev/api/services';
+/**
+ * Whether a `TransferWithMemo` memo is an MPP attribution memo: a full 32-byte
+ * value prefixed with the {@link attributionTag}.
+ */
+export function isAttributionMemo(memo) {
+    return memo.length === 66 && memo.toLowerCase().startsWith(attributionTag);
+}
+/**
+ * Extracts the 10-byte MPP server fingerprint from an attribution memo, or
+ * undefined when the memo is not an attribution memo. The fingerprint occupies
+ * bytes 5–14 (after the 4-byte tag and a 1-byte version), matching the
+ * `0x`-prefixed lowercase hex keys produced by {@link fingerprintForRealm}.
+ */
+export function extractFingerprint(memo) {
+    if (!isAttributionMemo(memo))
+        return undefined;
+    return `0x${memo.slice(12, 32).toLowerCase()}`;
+}
+/**
+ * Computes the MPP server fingerprint for a service realm: the first 10 bytes
+ * of `keccak256(realm)`, lowercased. The directory and the memo agree on this
+ * derivation, so a memo fingerprint can be matched against the directory map.
+ */
+export function fingerprintForRealm(realm) {
+    const hash = Hash.keccak256(Hex.fromString(realm), { as: 'Hex' });
+    return Hex.slice(hash, 0, 10).toLowerCase();
+}
+/**
+ * Resolves the service display name for a transfer from its attribution memo:
+ * the live directory entry for the memo's fingerprint, falling back to the
+ * generic `MPP Service` label when the memo is an attribution memo whose
+ * fingerprint is not (yet) in the directory. Returns undefined when there is no
+ * attribution memo (e.g. inbound transfers reconstructed without log data, or
+ * plain non-MPP transfers).
+ */
+export function resolve(options) {
+    const { fingerprintMap, memo } = options;
+    if (!memo || !fingerprintMap || !isAttributionMemo(memo))
+        return undefined;
+    const fingerprint = extractFingerprint(memo);
+    if (fingerprint) {
+        const name = fingerprintMap[fingerprint];
+        if (name)
+            return name;
+    }
+    return 'MPP Service';
+}
+/**
+ * Fetches and memoizes the live MPP directory as a fingerprint → service-name
+ * map, so attribution memos can be resolved to current service names. The fetch
+ * is bounded by a short timeout; only successful results are cached (failures
+ * propagate so the next call retries rather than caching an empty map).
+ */
+export async function fingerprintMap(options) {
+    const { store, ttl = Ttl.minutes(10), url = directoryUrl } = options;
+    return Store.memoize(async () => {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 1_000);
+        try {
+            const response = await fetch(url, {
+                headers: { accept: 'application/json' },
+                signal: controller.signal,
+            });
+            if (!response.ok)
+                throw new UpstreamError(response.status);
+            const data = (await response.json());
+            const map = {};
+            for (const service of data.services) {
+                // A service without an explicit realm (or the shared default realm)
+                // derives its realm from its id under the canonical MPP domain.
+                const realm = service.realm && service.realm !== 'mpp.tempo.xyz'
+                    ? service.realm
+                    : `${service.id}.mpp.tempo.xyz`;
+                map[fingerprintForRealm(realm)] = service.name;
+            }
+            return map;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }, { key: 'mpp-services:v1', store, ttl });
+}
+/** Thrown when the MPP directory endpoint returns a non-2xx status. */
+export class UpstreamError extends Error {
+    /** The HTTP status returned by the directory endpoint. */
+    status;
+    constructor(status) {
+        super(`MPP directory request failed with status ${status}`);
+        this.name = 'Mpp.UpstreamError';
+        this.status = status;
+    }
+}
+//# sourceMappingURL=Mpp.js.map

package/dist/internal/Mpp.js.map

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