tapimo 0.7.2 → 0.9.0

package/dist/apps/mcp.js

@@ -4,12 +4,14 @@ import * as z from 'zod/mini';
 import * as Auth from '../internal/Auth.js';
 import * as OpenApi from '../internal/OpenApi.js';
 import * as Metadata from './metadata.js';
-/** Document tag group whose operations surface as MCP tools (the data domain). */
-const tagGroup = 'Data API';
+/** Required document tag group whose operations surface as MCP tools. */
+const dataTagGroup = 'Data API';
+/** Optional document tag group added when the funding app is mounted. */
+const fundingTagGroup = 'Funding & Bridge API';
 /** Tags inside the group hidden from MCP: partner-shaped CoinGecko mirrors and the MCP endpoint itself. */
 const excludedTags = ['CoinGecko', 'MCP'];
 /** Usage guidance surfaced to MCP clients on initialize. */
-const instructions = "Tempo MCP provides access to the Tempo API's data domain and documentation. Authenticated tools accept a Tempo API key sent as an `Authorization: Bearer` header on the HTTP request. List endpoints paginate via `cursor`/`nextCursor`. `docs_*` tools search the Tempo documentation.";
+const instructions = "Tempo MCP provides access to the Tempo API's data and inbound funding domains, plus documentation. Authenticated tools accept a Tempo API key sent as an `Authorization: Bearer` header on the HTTP request. List endpoints paginate via `cursor`/`nextCursor`. `docs_*` tools search the Tempo documentation.";
 /** Zod schemas owned by the MCP endpoint's OpenAPI description. */
 export var schema;
 (function (schema) {
@@ -45,9 +47,8 @@ export var schema;
 })(schema || (schema = {}));
 /**
  * The MCP route group: a stateless streamable-HTTP MCP server at `/mcp` whose
- * tools mirror the API's data domain (scoped via the OpenAPI document's
- * `Data API` tag group), plus the remote Tempo docs tools. Mount alongside
- * the other route groups:
+ * tools mirror the API's data domain and its optional inbound funding domain,
+ * plus the remote Tempo docs tools. Mount alongside the other route groups:
  *
  * ```ts
  * const app = App.create(options)
@@ -172,20 +173,21 @@ const openapi = {
             description: 'A hosted Model Context Protocol server: the data domain and Tempo docs exposed as tools.',
         },
     ],
-    'x-tagGroups': [{ name: tagGroup, tags: ['MCP'] }],
+    'x-tagGroups': [{ name: dataTagGroup, tags: ['MCP'] }],
 };
 /** HTTP methods that carry operations in an OpenAPI path item. */
 const methods = ['delete', 'get', 'head', 'options', 'patch', 'post', 'put', 'trace']; // prettier-ignore
 /**
- * Narrows the document to the data domain: operations tagged inside the
- * `Data API` tag group, minus excluded tags. Management, relay, and session
- * operations never surface as tools.
+ * Narrows the document to the data and optional inbound funding domains.
+ * Management, relay, and session operations never surface as tools.
  */
 function scope(document) {
-    const group = document['x-tagGroups']?.find((entry) => entry.name === tagGroup);
-    if (!group)
-        throw new Error(`openapi.json is missing the "${tagGroup}" tag group`);
-    const tags = new Set(group.tags.filter((tag) => !excludedTags.includes(tag)));
+    const groups = document['x-tagGroups'] ?? [];
+    const dataGroup = groups.find((entry) => entry.name === dataTagGroup);
+    if (!dataGroup)
+        throw new Error(`openapi.json is missing the "${dataTagGroup}" tag group`);
+    const fundingGroup = groups.find((entry) => entry.name === fundingTagGroup);
+    const tags = new Set([...dataGroup.tags, ...(fundingGroup?.tags ?? [])].filter((tag) => !excludedTags.includes(tag)));
     const paths = {};
     for (const [path, item] of Object.entries(document.paths)) {
         // Keep in-domain operations; non-method keys (parameters, summary) ride along.

package/dist/apps/mcp.js.map

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

package/dist/apps/metadata.d.ts

@@ -4,4 +4,8 @@ import type * as App from '../App.js';
 export declare function attach<const app extends Hono<any, any>>(app: app, metadata: App.create.Metadata): app;
 /** Reads the OpenAPI metadata attached to an app instance, if any. */
 export declare function read(app: Hono<any, any>): App.create.Metadata | undefined;
+/** Marks a group whose routes use the root app's default chain access policy. */
+export declare function defaultChain<const app extends Hono<any, any>>(app: app): app;
+/** Returns whether a group uses the root app's default chain access policy. */
+export declare function usesDefaultChain(app: Hono<any, any>): boolean;
 //# sourceMappingURL=metadata.d.ts.map

package/dist/apps/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/apps/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEhC,OAAO,KAAK,KAAK,GAAG,MAAM,WAAW,CAAA;AAQrC,gGAAgG;AAChG,wBAAgB,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EACrD,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,GAC5B,GAAG,CAGL;AAED,sEAAsE;AACtE,wBAAgB,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,SAAS,CAEzE"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/apps/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEhC,OAAO,KAAK,KAAK,GAAG,MAAM,WAAW,CAAA;AASrC,gGAAgG;AAChG,wBAAgB,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EACrD,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,GAC5B,GAAG,CAGL;AAED,sEAAsE;AACtE,wBAAgB,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,SAAS,CAEzE;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,CAG5E;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAE7D"}

package/dist/apps/metadata.js

@@ -3,6 +3,7 @@
 // `App.create` reads it back on mount. The `WeakMap` keeps the association off
 // the app's type, so `testClient`/`hc` inference is untouched.
 const registry = new WeakMap();
+const defaultChainRegistry = new WeakSet();
 /** Attaches a group's OpenAPI metadata to its app instance for `create` to collect on mount. */
 export function attach(app, metadata) {
     registry.set(app, metadata);
@@ -12,4 +13,13 @@ export function attach(app, metadata) {
 export function read(app) {
     return registry.get(app);
 }
+/** Marks a group whose routes use the root app's default chain access policy. */
+export function defaultChain(app) {
+    defaultChainRegistry.add(app);
+    return app;
+}
+/** Returns whether a group uses the root app's default chain access policy. */
+export function usesDefaultChain(app) {
+    return defaultChainRegistry.has(app);
+}
 //# sourceMappingURL=metadata.js.map

package/dist/apps/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/apps/metadata.ts"],"names":[],"mappings":"AAIA,gFAAgF;AAChF,0EAA0E;AAC1E,+EAA+E;AAC/E,+DAA+D;AAC/D,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAuC,CAAA;AAEnE,gGAAgG;AAChG,MAAM,UAAU,MAAM,CACpB,GAAQ,EACR,QAA6B;IAE7B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAC3B,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,IAAI,CAAC,GAAmB;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/apps/metadata.ts"],"names":[],"mappings":"AAIA,gFAAgF;AAChF,0EAA0E;AAC1E,+EAA+E;AAC/E,+DAA+D;AAC/D,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAuC,CAAA;AACnE,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAAkB,CAAA;AAE1D,gGAAgG;AAChG,MAAM,UAAU,MAAM,CACpB,GAAQ,EACR,QAA6B;IAE7B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAC3B,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,IAAI,CAAC,GAAmB;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAmC,GAAQ;IACrE,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC7B,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,GAAmB;IAClD,OAAO,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AACtC,CAAC"}

package/dist/apps/mpp/App.d.ts

@@ -7,15 +7,16 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
     "/v1/mpp/validate": {
         $post: {
             output: {
+                success: true;
+            } | {
                 error: {
-                    code: "api_key_malformed";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
+                    code: "already_used" | "broadcast_failed" | "expired" | "insufficient_funds" | "invalid_payment" | "policy_denied" | "screen_rejected" | "simulation_failed" | "temporarily_unavailable" | "unknown" | "unsupported";
+                    message?: string | undefined;
                 };
-                requestId: string;
+                success: false;
             };
             outputFormat: "json";
-            status: 400;
+            status: 200;
             input: {
                 json: {
                     challenge: {
@@ -35,14 +36,14 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            status: 400;
             input: {
                 json: {
                     challenge: {
@@ -62,14 +63,14 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
         } | {
             output: {
                 error: {
-                    code: "api_key_forbidden";
+                    code: "body_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 400;
             input: {
                 json: {
                     challenge: {
@@ -89,14 +90,14 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
         } | {
             output: {
                 error: {
-                    code: "payment_required" | "rate_limit_exceeded";
+                    code: "api_key_invalid" | "api_key_missing";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 429;
+            status: 401;
             input: {
                 json: {
                     challenge: {
@@ -116,14 +117,14 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
         } | {
             output: {
                 error: {
-                    code: "body_invalid";
+                    code: "api_key_forbidden" | "api_key_ip_forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 403;
             input: {
                 json: {
                     challenge: {
@@ -142,16 +143,15 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
             };
         } | {
             output: {
-                success: true;
-            } | {
                 error: {
-                    code: "already_used" | "broadcast_failed" | "expired" | "insufficient_funds" | "invalid_payment" | "policy_denied" | "screen_rejected" | "simulation_failed" | "temporarily_unavailable" | "unknown" | "unsupported";
-                    message?: string | undefined;
+                    code: "payment_required" | "rate_limit_exceeded";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
                 };
-                success: false;
+                requestId: string;
             };
             outputFormat: "json";
-            status: 200;
+            status: 429;
             input: {
                 json: {
                     challenge: {
@@ -174,15 +174,22 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
     "/v1/mpp/broadcast": {
         $post: {
             output: {
+                receipt: {
+                    externalId?: string | undefined;
+                    method: string;
+                    reference: string;
+                    timestamp: string;
+                };
+                success: true;
+            } | {
                 error: {
-                    code: "api_key_malformed";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
+                    code: "already_used" | "broadcast_failed" | "expired" | "insufficient_funds" | "invalid_payment" | "policy_denied" | "screen_rejected" | "simulation_failed" | "temporarily_unavailable" | "unknown" | "unsupported";
+                    message?: string | undefined;
                 };
-                requestId: string;
+                success: false;
             };
             outputFormat: "json";
-            status: 400;
+            status: 200;
             input: {
                 json: {
                     challenge: {
@@ -202,14 +209,14 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            status: 400;
             input: {
                 json: {
                     challenge: {
@@ -229,14 +236,14 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
         } | {
             output: {
                 error: {
-                    code: "api_key_forbidden";
+                    code: "body_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 400;
             input: {
                 json: {
                     challenge: {
@@ -256,14 +263,14 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
         } | {
             output: {
                 error: {
-                    code: "payment_required" | "rate_limit_exceeded";
+                    code: "api_key_invalid" | "api_key_missing";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 429;
+            status: 401;
             input: {
                 json: {
                     challenge: {
@@ -283,14 +290,14 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
         } | {
             output: {
                 error: {
-                    code: "body_invalid";
+                    code: "api_key_forbidden" | "api_key_ip_forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 403;
             input: {
                 json: {
                     challenge: {
@@ -309,22 +316,15 @@ export declare function mpp(options: mpp.Options): import("hono/hono-base").Hono
             };
         } | {
             output: {
-                receipt: {
-                    externalId?: string | undefined;
-                    method: string;
-                    reference: string;
-                    timestamp: string;
-                };
-                success: true;
-            } | {
                 error: {
-                    code: "already_used" | "broadcast_failed" | "expired" | "insufficient_funds" | "invalid_payment" | "policy_denied" | "screen_rejected" | "simulation_failed" | "temporarily_unavailable" | "unknown" | "unsupported";
-                    message?: string | undefined;
+                    code: "payment_required" | "rate_limit_exceeded";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
                 };
-                success: false;
+                requestId: string;
             };
             outputFormat: "json";
-            status: 200;
+            status: 429;
             input: {
                 json: {
                     challenge: {

package/dist/cloudflare.d.ts

@@ -1,4 +1,6 @@
 import { DurableObject as CloudflareDurableObject } from 'cloudflare:workers';
+import * as Funding from './internal/funding/index.js';
+import * as Metrics from './Metrics.js';
 import * as Store from './internal/Store.js';
 type State = ConstructorParameters<typeof CloudflareDurableObject>[0];
 type Environment = ConstructorParameters<typeof CloudflareDurableObject>[1];
@@ -37,5 +39,53 @@ export declare class DurableObject extends CloudflareDurableObject {
      */
     swap(key: string, expected: null | string, next: string, options?: Store.Store.PutOptions): Promise<boolean>;
 }
+type FundingSourceConfiguration = {
+    chainId: string;
+    rpcUrls: readonly string[];
+    tokenAddress: string;
+};
+type FundingSourceRoute = Funding.SourceObservation.Route;
+type FundingSourceRegisterOptions = FundingSourceConfiguration & {
+    route: FundingSourceRoute;
+};
+type FundingSourceSyncOptions = FundingSourceConfiguration & {
+    routes: readonly FundingSourceRoute[];
+};
+/** Cloudflare Durable Object that detects EVM funding deposits before provider indexing. */
+export declare class FundingSourceObserver<environment extends FundingSourceObserver.Environment = FundingSourceObserver.Environment> extends CloudflareDurableObject {
+    #private;
+    /** Durable Object storage and alarm context. */
+    protected context: State;
+    /** Cloudflare bindings used by the observer. */
+    protected environment: environment;
+    constructor(ctx: State, env: environment);
+    /** Registers one newly created deposit address and starts source observation. */
+    register(options: FundingSourceRegisterOptions): Promise<void>;
+    /** Replaces the active routes from the database and repairs alarm scheduling. */
+    sync(options: FundingSourceSyncOptions): Promise<void>;
+    /** Scans confirmed source blocks and persists newly observed deposits. */
+    alarm(): Promise<void>;
+    /** Reports one source-observer failure. */
+    protected capture(cause: unknown): void;
+    /** Creates the operational metric sink used by one alarm invocation. */
+    protected createMetrics(): Metrics.Metrics;
+}
+export declare namespace FundingSourceObserver {
+    /** Cloudflare bindings and deployment metadata used by the observer. */
+    type Environment = {
+        /** Deployment environment included in operational metrics. */
+        ENVIRONMENT?: string | undefined;
+        /** Queue that receives deposit-address reconciliation work. */
+        FUNDING_RECONCILIATION_QUEUE: {
+            /** Enqueues one chain-detected address for reconciliation. */
+            send(message: Funding.Provider.Webhook.receive.Dispatchable): Promise<unknown>;
+        };
+        /** Authoritative Postgres connection exposed through Hyperdrive. */
+        HYPERDRIVE: {
+            /** PostgreSQL connection string supplied by the Hyperdrive binding. */
+            connectionString: string;
+        };
+    };
+}
 export {};
 //# sourceMappingURL=cloudflare.d.ts.map

package/dist/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,IAAI,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAE7E,OAAO,KAAK,KAAK,MAAM,qBAAqB,CAAA;AAE5C,KAAK,KAAK,GAAG,qBAAqB,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAA;AACrE,KAAK,WAAW,GAAG,qBAAqB,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAA;AAE3E,+EAA+E;AAC/E,qBAAa,aAAc,SAAQ,uBAAuB;;IAGxD,YAAY,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAMvC;IAED,qBAAqB;IACf,MAAM,CAAC,GAAG,EAAE,MAAM,iBAEvB;IAED,4DAA4D;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,oBAElD;IAED,uEAAuE;IACjE,GAAG,CAAC,GAAG,EAAE,MAAM,0BAEpB;IAED;;;;;;;OAOG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,mBAE5D;IAED,kBAAkB;IACZ,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;;;;OAEtD;IAED,6DAA6D;IACvD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,iBAErE;IAED;;;;;OAKG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,oBAE9F;CACF"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"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"}

package/dist/cloudflare.js

@@ -3,6 +3,9 @@
 // web types like `Response.json`.
 // @ts-ignore
 import { DurableObject as CloudflareDurableObject } from 'cloudflare:workers';
+import * as Db from './db/Db.js';
+import * as Funding from './internal/funding/index.js';
+import * as Metrics from './Metrics.js';
 import * as Store from './internal/Store.js';
 /** Durable Object class that exposes a Tempo API store over Cloudflare RPC. */
 export class DurableObject extends CloudflareDurableObject {
@@ -55,4 +58,179 @@ export class DurableObject extends CloudflareDurableObject {
         return this.#store.swap(key, expected, next, options);
     }
 }
+const fundingSourceAlarmIntervalMs = 500;
+const fundingSourceRetryIntervalMs = 2_000;
+/** Cloudflare Durable Object that detects EVM funding deposits before provider indexing. */
+export class FundingSourceObserver extends CloudflareDurableObject {
+    /** Durable Object storage and alarm context. */
+    context;
+    /** Cloudflare bindings used by the observer. */
+    environment;
+    constructor(ctx, env) {
+        super(ctx, env);
+        this.context = ctx;
+        this.environment = env;
+        void ctx.blockConcurrencyWhile(async () => {
+            ctx.storage.sql.exec('CREATE TABLE IF NOT EXISTS configuration (id INTEGER PRIMARY KEY CHECK (id = 1), value TEXT NOT NULL)');
+            ctx.storage.sql.exec('CREATE TABLE IF NOT EXISTS backfills (id TEXT PRIMARY KEY)');
+            ctx.storage.sql.exec('CREATE TABLE IF NOT EXISTS routes (id TEXT PRIMARY KEY, address TEXT NOT NULL UNIQUE)');
+            ctx.storage.sql.exec('CREATE TABLE IF NOT EXISTS state (key TEXT PRIMARY KEY, value TEXT NOT NULL)');
+        });
+    }
+    /** Registers one newly created deposit address and starts source observation. */
+    async register(options) {
+        const configuration = serializeFundingSourceConfiguration(options);
+        const route = this.context.storage.sql
+            .exec('SELECT id, address FROM routes WHERE id = ?', options.route.id)
+            .toArray()[0];
+        this.context.storage.transactionSync(() => {
+            this.context.storage.sql.exec('INSERT OR REPLACE INTO configuration (id, value) VALUES (1, ?)', configuration);
+            this.context.storage.sql.exec('INSERT OR REPLACE INTO routes (id, address) VALUES (?, ?)', options.route.id, options.route.address.toLowerCase());
+            if (!route || route.address.toLowerCase() !== options.route.address.toLowerCase())
+                this.context.storage.sql.exec('INSERT OR IGNORE INTO backfills (id) VALUES (?)', options.route.id);
+        });
+        await this.#ensureAlarm();
+    }
+    /** Replaces the active routes from the database and repairs alarm scheduling. */
+    async sync(options) {
+        const configuration = serializeFundingSourceConfiguration(options);
+        const existing = new Map(this.context.storage.sql
+            .exec('SELECT id, address FROM routes ORDER BY id')
+            .toArray()
+            .map((route) => [route.id, route.address.toLowerCase()]));
+        const changed = options.routes.filter((route) => existing.get(route.id) !== route.address.toLowerCase());
+        this.context.storage.transactionSync(() => {
+            this.context.storage.sql.exec('INSERT OR REPLACE INTO configuration (id, value) VALUES (1, ?)', configuration);
+            this.context.storage.sql.exec('DELETE FROM routes');
+            for (const route of options.routes)
+                this.context.storage.sql.exec('INSERT INTO routes (id, address) VALUES (?, ?)', route.id, route.address.toLowerCase());
+            this.context.storage.sql.exec('DELETE FROM backfills WHERE id NOT IN (SELECT id FROM routes)');
+            for (const route of changed)
+                this.context.storage.sql.exec('INSERT OR IGNORE INTO backfills (id) VALUES (?)', route.id);
+        });
+        if (options.routes.length === 0) {
+            await this.context.storage.deleteAlarm();
+            return;
+        }
+        await this.#ensureAlarm();
+    }
+    /** Scans confirmed source blocks and persists newly observed deposits. */
+    async alarm() {
+        const metrics = this.createMetrics();
+        const configuration = this.#readConfiguration();
+        const routes = this.context.storage.sql
+            .exec('SELECT id, address FROM routes ORDER BY id')
+            .toArray();
+        if (!configuration || routes.length === 0)
+            return;
+        try {
+            const cursor = this.context.storage.sql
+                .exec("SELECT value FROM state WHERE key = 'cursor'")
+                .toArray()[0];
+            const result = await Funding.SourceObservation.scan({
+                chainId: configuration.chainId,
+                ...(cursor ? { cursor: BigInt(cursor.value) } : {}),
+                routes,
+                rpcUrls: configuration.rpcUrls,
+                tokenAddress: configuration.tokenAddress,
+            });
+            const backfills = this.context.storage.sql
+                .exec('SELECT routes.id, routes.address FROM routes INNER JOIN backfills ON backfills.id = routes.id ORDER BY routes.id')
+                .toArray();
+            // Backfill new routes independently so the main cursor retains any older shard backlog.
+            const backfill = await (async () => {
+                if (!cursor || backfills.length === 0)
+                    return undefined;
+                return Funding.SourceObservation.scan({
+                    chainId: configuration.chainId,
+                    routes: backfills,
+                    rpcUrls: configuration.rpcUrls,
+                    tokenAddress: configuration.tokenAddress,
+                });
+            })();
+            const database = Db.get(() => Db.postgres({ connectionString: this.environment.HYPERDRIVE.connectionString }));
+            const routesById = new Map(routes.map((route) => [route.id, route]));
+            const observations = new Map([...result.observations, ...(backfill?.observations ?? [])].map((observation) => [
+                `${observation.addressId}:${observation.transactionHash.toLowerCase()}:${observation.transferIndex}`,
+                observation,
+            ])).values();
+            for (const observation of observations) {
+                const route = routesById.get(observation.addressId);
+                if (!route)
+                    continue;
+                const persisted = await Funding.SourceObservation.observe(database, {
+                    ...observation,
+                    recipient: route.address,
+                });
+                if (persisted.type === 'ignored' ||
+                    persisted.record.providerRequestId !== null ||
+                    Funding.Deposit.isTerminal(persisted.record.status))
+                    continue;
+                await this.environment.FUNDING_RECONCILIATION_QUEUE.send({
+                    addressId: observation.addressId,
+                    trigger: 'chain',
+                    type: 'funding:deposit-address:reconcile',
+                });
+                metrics.count('funding_source_observer_deposit_count', 1, {
+                    chain: configuration.chainId,
+                    outcome: persisted.type,
+                });
+            }
+            this.context.storage.transactionSync(() => {
+                this.context.storage.sql.exec("INSERT OR REPLACE INTO state (key, value) VALUES ('cursor', ?)", result.cursor.toString());
+                for (const route of backfills)
+                    this.context.storage.sql.exec('DELETE FROM backfills WHERE id = ?', route.id);
+            });
+            metrics.count('funding_source_observer_scan_count', 1, {
+                chain: configuration.chainId,
+                outcome: 'completed',
+            });
+            metrics.gauge('funding_source_observer_block_lag', Math.max(0, Number(result.head - result.cursor)), { chain: configuration.chainId });
+            await this.context.storage.setAlarm(result.cursor < result.head ? Date.now() : Date.now() + fundingSourceAlarmIntervalMs);
+        }
+        catch (cause) {
+            metrics.count('funding_source_observer_scan_count', 1, {
+                chain: configuration.chainId,
+                outcome: 'failed',
+            });
+            this.capture(cause);
+            await this.context.storage.setAlarm(Date.now() + fundingSourceRetryIntervalMs);
+        }
+        finally {
+            metrics.flush();
+        }
+    }
+    /** Reports one source-observer failure. */
+    capture(cause) {
+        console.error(cause);
+    }
+    /** Creates the operational metric sink used by one alarm invocation. */
+    createMetrics() {
+        return Metrics.cloudflare({
+            enabled: Boolean(this.environment.ENVIRONMENT),
+            environment: this.environment.ENVIRONMENT ?? 'development',
+            service: 'tapimo',
+        });
+    }
+    #configuration() {
+        return this.context.storage.sql
+            .exec('SELECT value FROM configuration WHERE id = 1')
+            .toArray()[0]?.value;
+    }
+    async #ensureAlarm() {
+        if ((await this.context.storage.getAlarm()) === null)
+            await this.context.storage.setAlarm(Date.now());
+    }
+    #readConfiguration() {
+        const value = this.#configuration();
+        return value ? JSON.parse(value) : undefined;
+    }
+}
+function serializeFundingSourceConfiguration(options) {
+    return JSON.stringify({
+        chainId: options.chainId,
+        rpcUrls: options.rpcUrls,
+        tokenAddress: options.tokenAddress.toLowerCase(),
+    });
+}
 //# sourceMappingURL=cloudflare.js.map