tapimo 0.0.2 → 0.2.0

package/dist/apps/platform/routes/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../../src/apps/platform/routes/projects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAG7B,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAA;AAK3C,OAAO,KAAK,QAAQ,MAAM,+BAA+B,CAAA;AAMzD,kDAAkD;AAClD,yBAAiB,MAAM,CAAC;IAUtB,iEAAiE;IAC1D,MAAM,OAAO;;;;;;;;;;qBAmCnB,CAAA;IAED,uEAAuE;IAChE,MAAM,MAAM;;qBASoD,CAAA;IAEvE,8CAA8C;IACvC,MAAM,aAAa;;;qBAe8B,CAAA;IAExD,mDAAmD;IAC5C,MAAM,WAAW;;qBAE0C,CAAA;IAElE,+CAA+C;IAC/C,UAAiB,aAAa,CAAC;QAC7B,iDAAiD;QAC1C,MAAM,QAAQ;;yBAS6C,CAAA;KACnE;IAED,8CAA8C;IAC9C,UAAiB,YAAY,CAAC;QAC5B,wDAAwD;QACjD,MAAM,QAAQ;;;;;;;;;;;;yBAKpB,CAAA;KACF;CACF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uFAwNvB"}

package/dist/apps/platform/routes/projects.js

@@ -0,0 +1,286 @@
+import { Hono } from 'hono';
+import * as z from 'zod/mini';
+import * as ApiKeys from '../../../ApiKeys.js';
+import * as Auth from '../../../internal/Auth.js';
+import * as Db from '../../../db/Db.js';
+import * as OpenApi from '../../../internal/OpenApi.js';
+import * as Projects from '../../../db/tables/projects.js';
+import * as Response from '../../../internal/Response.js';
+import * as Schema from '../../../internal/Schema.js';
+/** Environments every project exposes; sandbox maps to testnet, production to mainnet. */
+const environments = ['production', 'sandbox'];
+/** Zod schemas owned by the projects resource. */
+export var schema;
+(function (schema) {
+    const name = z
+        .string()
+        .check(z.minLength(1), z.maxLength(100), z.describe('Human-readable name.'), z.meta({ examples: ['Checkout'] }));
+    /** One project: an app or integration within an organization. */
+    schema.Project = Schema.describe(z.object({
+        createdAt: z
+            .string()
+            .check(z.describe('When the project was created (ISO 8601).'), z.meta({ examples: ['2026-01-01T00:00:00.000Z'] })),
+        environments: z.array(z.enum(environments)).check(z.describe('Environments available to this project: sandbox (testnet) and production (mainnet).'), // prettier-ignore
+        z.meta({ examples: [[...environments]] })),
+        id: z
+            .string()
+            .check(z.describe('Opaque project id (`prj_…`).'), z.meta({ examples: ['prj_1a2b3c4d5e6f7g8h9j0k1m2n'] })),
+        name: z
+            .string()
+            .check(z.describe('Human-readable project name.'), z.meta({ examples: ['Checkout'] })),
+        orgId: z
+            .string()
+            .check(z.describe('Owning organization id (`org_…`).'), z.meta({ examples: ['org_1a2b3c4d5e6f7g8h9j0k1m2n'] })),
+        updatedAt: z
+            .string()
+            .check(z.describe('When the project was last updated (ISO 8601).'), z.meta({ examples: ['2026-01-01T00:00:00.000Z'] })),
+    }), 'A project: an app or integration within an organization.');
+    /** Path parameters addressing an organization's project collection. */
+    schema.Params = z
+        .object({
+        orgId: z
+            .string()
+            .check(z.describe('The organization id (`org_…`).'), z.meta({ examples: ['org_1a2b3c4d5e6f7g8h9j0k1m2n'] })),
+    })
+        .check(z.describe("Path parameters for an organization's projects."));
+    /** Path parameters addressing one project. */
+    schema.ProjectParams = z
+        .object({
+        orgId: z
+            .string()
+            .check(z.describe('The organization id (`org_…`).'), z.meta({ examples: ['org_1a2b3c4d5e6f7g8h9j0k1m2n'] })),
+        projectId: z
+            .string()
+            .check(z.describe('The project id (`prj_…`).'), z.meta({ examples: ['prj_1a2b3c4d5e6f7g8h9j0k1m2n'] })),
+    })
+        .check(z.describe('Path parameters for one project.'));
+    /** Request body creating or renaming a project. */
+    schema.ProjectBody = z
+        .object({ name })
+        .check(z.describe('Fields for creating or renaming a project.'));
+    /** Schemas for the deleteProject operation. */
+    let deleteProject;
+    (function (deleteProject) {
+        /** Confirmation that the project was deleted. */
+        deleteProject.Response = z
+            .object({
+            id: z
+                .string()
+                .check(z.describe('ID of the project that was deleted.'), z.meta({ examples: ['prj_1a2b3c4d5e6f7g8h9j0k1m2n'] })),
+        })
+            .check(z.describe('Confirmation that the project was deleted.'));
+    })(deleteProject = schema.deleteProject || (schema.deleteProject = {}));
+    /** Schemas for the listProjects operation. */
+    let listProjects;
+    (function (listProjects) {
+        /** Non-paginated list of an organization's projects. */
+        listProjects.Response = Schema.describe(z.object({
+            data: z.array(schema.Project).check(z.describe('The projects, newest first.')),
+        }), "A non-paginated list of an organization's projects.");
+    })(listProjects = schema.listProjects || (schema.listProjects = {}));
+})(schema || (schema = {}));
+/**
+ * Mounts the `/orgs/:orgId/projects` resource: projects nested under their
+ * owning organization. Access follows the org scope (owning session or super
+ * admin); inaccessible or absent ids render `404`.
+ */
+export function projects() {
+    return new Hono()
+        .get('/v1/orgs/:orgId{org_[A-Za-z0-9_-]+}/projects', Auth.policy({ session: true }), Auth.ensureOrg(), OpenApi.validate('param', schema.Params, {
+        code: 'param_invalid',
+        message: 'Check the path parameters and try again.',
+    }), OpenApi.describeRoute({
+        operationId: 'listProjects',
+        responses: OpenApi.responses({
+            errors: { 404: 'No accessible organization was found for this id.' },
+            success: {
+                description: "The organization's projects, newest first.",
+                schema: schema.listProjects.Response,
+            },
+        }),
+        summary: 'List projects',
+        tags: ['Projects'],
+    }), async (c) => {
+        if (Auth.narrowAccess)
+            return Auth.superAdminAccessError(c);
+        if (Auth.narrowScope)
+            return Auth.ensureOrgError(c);
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'param_invalid',
+                message: 'Check the path parameters and try again.',
+            });
+        const db = Db.get(c.get('db'));
+        try {
+            const records = await Projects.listByOrg(db, Auth.org(c).id);
+            return c.json(Response.validated(schema.listProjects.Response, {
+                data: records.map(serializeProject),
+            }), 200);
+        }
+        catch (cause) {
+            return Response.upstream(c, cause);
+        }
+    })
+        .post('/v1/orgs/:orgId{org_[A-Za-z0-9_-]+}/projects', Auth.policy({ session: true }), Auth.ensureOrg({ role: 'admin' }), OpenApi.validate('param', schema.Params, {
+        code: 'param_invalid',
+        message: 'Check the path parameters and try again.',
+    }), OpenApi.validate('json', schema.ProjectBody, {
+        code: 'body_invalid',
+        message: 'Check the request body and try again.',
+    }), OpenApi.describeRoute({
+        operationId: 'createProject',
+        responses: OpenApi.responses({
+            errors: { 404: 'No accessible organization was found for this id.' },
+            success: { description: 'The created project.', schema: schema.Project },
+        }),
+        summary: 'Create project',
+        tags: ['Projects'],
+    }), async (c) => {
+        if (Auth.narrowAccess)
+            return Auth.superAdminAccessError(c);
+        if (Auth.narrowScope)
+            return Auth.ensureOrgError(c);
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'param_invalid',
+                message: 'Check the path parameters and try again.',
+            });
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'body_invalid',
+                message: 'Check the request body and try again.',
+            });
+        const body = c.req.valid('json');
+        const db = Db.get(c.get('db'));
+        try {
+            const record = await Projects.create(db, { name: body.name, orgId: Auth.org(c).id });
+            return c.json(Response.validated(schema.Project, serializeProject(record)), 200);
+        }
+        catch (cause) {
+            return Response.upstream(c, cause);
+        }
+    })
+        .get('/v1/orgs/:orgId{org_[A-Za-z0-9_-]+}/projects/:projectId{prj_[A-Za-z0-9_-]+}', Auth.policy({ session: true }), Auth.ensureOrg(), Auth.ensureProject(), OpenApi.validate('param', schema.ProjectParams, {
+        code: 'param_invalid',
+        message: 'Check the path parameters and try again.',
+    }), OpenApi.describeRoute({
+        operationId: 'getProject',
+        responses: OpenApi.responses({
+            errors: { 404: 'No accessible project was found for this id.' },
+            success: { description: 'One project.', schema: schema.Project },
+        }),
+        summary: 'Get project',
+        tags: ['Projects'],
+    }), async (c) => {
+        if (Auth.narrowAccess)
+            return Auth.superAdminAccessError(c);
+        if (Auth.narrowScope)
+            return Auth.ensureProjectError(c);
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'param_invalid',
+                message: 'Check the path parameters and try again.',
+            });
+        return c.json(Response.validated(schema.Project, serializeProject(Auth.project(c))), 200);
+    })
+        .patch('/v1/orgs/:orgId{org_[A-Za-z0-9_-]+}/projects/:projectId{prj_[A-Za-z0-9_-]+}', Auth.policy({ session: true }), Auth.ensureOrg({ role: 'admin' }), Auth.ensureProject(), OpenApi.validate('param', schema.ProjectParams, {
+        code: 'param_invalid',
+        message: 'Check the path parameters and try again.',
+    }), OpenApi.validate('json', schema.ProjectBody, {
+        code: 'body_invalid',
+        message: 'Check the request body and try again.',
+    }), OpenApi.describeRoute({
+        operationId: 'updateProject',
+        responses: OpenApi.responses({
+            errors: { 404: 'No accessible project was found for this id.' },
+            success: { description: 'The updated project.', schema: schema.Project },
+        }),
+        summary: 'Update project',
+        tags: ['Projects'],
+    }), async (c) => {
+        if (Auth.narrowAccess)
+            return Auth.superAdminAccessError(c);
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'param_invalid',
+                message: 'Check the path parameters and try again.',
+            });
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'body_invalid',
+                message: 'Check the request body and try again.',
+            });
+        if (Auth.narrowScope)
+            return Auth.ensureProjectError(c);
+        const body = c.req.valid('json');
+        const db = Db.get(c.get('db'));
+        try {
+            const updated = await Projects.update(db, Auth.project(c).id, { name: body.name });
+            if (!updated)
+                return projectNotFound(c);
+            return c.json(Response.validated(schema.Project, serializeProject(updated)), 200);
+        }
+        catch (cause) {
+            return Response.upstream(c, cause);
+        }
+    })
+        .delete('/v1/orgs/:orgId{org_[A-Za-z0-9_-]+}/projects/:projectId{prj_[A-Za-z0-9_-]+}', Auth.policy({ session: true }), Auth.ensureOrg({ role: 'admin' }), Auth.ensureProject(), OpenApi.validate('param', schema.ProjectParams, {
+        code: 'param_invalid',
+        message: 'Check the path parameters and try again.',
+    }), OpenApi.describeRoute({
+        operationId: 'deleteProject',
+        responses: OpenApi.responses({
+            errors: { 404: 'No accessible project was found for this id.' },
+            success: {
+                description: 'Confirmation that the project was deleted.',
+                schema: schema.deleteProject.Response,
+            },
+        }),
+        summary: 'Delete project',
+        tags: ['Projects'],
+    }), async (c) => {
+        if (Auth.narrowAccess)
+            return Auth.superAdminAccessError(c);
+        if (Auth.narrowScope)
+            return Auth.ensureProjectError(c);
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'param_invalid',
+                message: 'Check the path parameters and try again.',
+            });
+        const db = Db.get(c.get('db'));
+        try {
+            const kv = c.get('kv');
+            if (kv)
+                for (const record of await ApiKeys.listByOrg(kv.store, Auth.org(c).id, {
+                    projectId: Auth.project(c).id,
+                }))
+                    await ApiKeys.revoke(kv.store, record.id);
+            const deleted = await Projects.deleteProject(db, Auth.project(c).id);
+            if (!deleted)
+                return projectNotFound(c);
+            return c.json(Response.validated(schema.deleteProject.Response, { id: Auth.project(c).id }), 200);
+        }
+        catch (cause) {
+            return Response.upstream(c, cause);
+        }
+    });
+}
+function serializeProject(record) {
+    return {
+        createdAt: record.createdAt,
+        environments: [...environments],
+        id: record.id,
+        name: record.name,
+        orgId: record.orgId,
+        updatedAt: record.updatedAt,
+    };
+}
+function projectNotFound(c) {
+    return Response.error(c, {
+        code: 'project_not_found',
+        message: 'Project not found',
+        status: 404,
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/apps/platform/routes/projects.js.map

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

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

@@ -0,0 +1,41 @@
+import type * as App from '../../App.js';
+import * as Handler from '../../Handler.js';
+/**
+ * The relay route group: the wallet relay at `/rpc/relay`. Mount
+ * after `data()`, whose published chain clients and supported-chain set the
+ * middleware reads from request context.
+ *
+ * ```ts
+ * App.create(options).route('/', data()).route('/', relay())
+ * ```
+ */
+export declare function relay(options?: relay.Options): import("hono/hono-base").HonoBase<App.Environment, {
+    "/rpc/relay": {
+        $all: {
+            output: {};
+            outputFormat: string;
+            status: import("hono/utils/http-status").StatusCode;
+            input: {};
+        };
+    };
+} & {
+    "/rpc/relay/:chainId": {
+        $all: {
+            output: {};
+            outputFormat: string;
+            status: import("hono/utils/http-status").StatusCode;
+            input: {
+                param: {
+                    chainId: string;
+                };
+            };
+        };
+    };
+}, "/", "/rpc/relay/:chainId">;
+export declare namespace relay {
+    /** Options for the relay route group. */
+    type Options = {
+        feePayer?: Pick<NonNullable<Handler.relay.Options['feePayer']>, 'account' | 'feeToken' | 'name' | 'url'> | undefined;
+    };
+}
+//# sourceMappingURL=App.d.ts.map

package/dist/apps/relay/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../src/apps/relay/App.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAA;AAGxC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAQ3C;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,KAAK,CAAC,OAAY;;;;;;;;;;;;;;;;;;;;;;+BAehD;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,yCAAyC;IACzC,KAAK,OAAO,GAAG;QACb,QAAQ,CAAC,EACL,IAAI,CACF,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAC9C,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CACxC,GACD,SAAS,CAAA;KACd,CAAA;CACF"}

package/dist/apps/relay/App.js

@@ -0,0 +1,103 @@
+import { Hono } from 'hono';
+import { createMiddleware } from 'hono/factory';
+import { Addresses } from 'viem/tempo';
+import * as Db from '../../db/Db.js';
+import * as SponsoredTransactions from '../../db/tables/sponsoredTransactions.js';
+import * as Handler from '../../Handler.js';
+import * as Auth from '../../internal/Auth.js';
+import * as OpenApi from '../../internal/OpenApi.js';
+import * as Path from '../../internal/Path.js';
+import * as VerifiedTokens from '../../internal/VerifiedTokens.js';
+import * as Viem from '../../internal/Viem.js';
+import * as Scope from '../../Scope.js';
+/**
+ * The relay route group: the wallet relay at `/rpc/relay`. Mount
+ * after `data()`, whose published chain clients and supported-chain set the
+ * middleware reads from request context.
+ *
+ * ```ts
+ * App.create(options).route('/', data()).route('/', relay())
+ * ```
+ */
+export function relay(options = {}) {
+    const handler = middleware(options);
+    return new Hono()
+        .use('/rpc/relay', Auth.policy({ apiKey: { scopes: ['rpc-relay:read'] }, mpp: false, public: false }), OpenApi.describeRoute({ hide: true, summary: 'Relay RPC' }))
+        .use('/rpc/relay/*', Auth.policy({ apiKey: { scopes: ['rpc-relay:read'] }, mpp: false, public: false }), OpenApi.describeRoute({ hide: true, summary: 'Relay RPC' }))
+        .all('/rpc/relay', handler)
+        .all('/rpc/relay/:chainId', handler);
+}
+// The wallet relay middleware: proxies wallet JSON-RPC (fills, sponsored
+// sends) with wallet-aware enrichment. Built per request from context rather
+// than closed over group locals; relay traffic is low-QPS and the viem
+// clients are memoized upstream, so per-request handler construction is cheap.
+function middleware(options = {}) {
+    return createMiddleware(async (c) => {
+        const verifiedTokens = c.get('verifiedTokens');
+        const feePayer = (() => {
+            if (!options.feePayer)
+                return undefined;
+            const principal = Auth.getPrincipal(c);
+            const attribution = principal?.type === 'api_key' && principal.projectId !== undefined
+                ? {
+                    apiKeyId: principal.id,
+                    environment: principal.environment,
+                    orgId: principal.orgId,
+                    projectId: principal.projectId,
+                }
+                : undefined;
+            const sponsorable = attribution !== undefined &&
+                principal?.type === 'api_key' &&
+                (principal.apiKey.scopes.includes('rpc-relay:sponsor') ||
+                    principal.apiKey.scopes.includes(Scope.wildcard));
+            return {
+                ...options.feePayer,
+                feeToken: options.feePayer.feeToken ?? Addresses.pathUsd,
+                validate: ({ chainId }) => {
+                    // Allowlist the chains this deployment serves rather than denylisting
+                    // only mainnet: the relay resolves chainId from the request body, so
+                    // the query-string chain guard never sees it. Mainnet stays closed
+                    // until billing ships; nothing meters real fee-payer spend yet.
+                    const id = Number(chainId);
+                    return sponsorable && c.get('supportedChainIds').has(id) && !Viem.isMainnet(id);
+                },
+                onSponsored: async (event) => {
+                    if (!attribution)
+                        return;
+                    await SponsoredTransactions.upsert(Db.get(c.get('db')), {
+                        apiKeyId: attribution.apiKeyId,
+                        billable: attribution.environment === 'production',
+                        chainId: event.chainId,
+                        environment: attribution.environment,
+                        orgId: attribution.orgId,
+                        projectId: attribution.projectId,
+                        signPayload: event.signPayload,
+                        transaction: event.transaction,
+                        ...(event.feeToken ? { feeToken: event.feeToken } : {}),
+                        ...(event.transactionHash ? { transactionHash: event.transactionHash } : {}),
+                    });
+                },
+            };
+        })();
+        // Dispatching a standalone Hono via `fetch(c.req.raw)` bypasses Hono's
+        // mount-path stripping, so its internal routes register at the request's
+        // full external path (`basePath` + `/rpc/relay`).
+        const handler = Handler.relay({
+            cache: c.get('store'),
+            features: 'all',
+            getClient: (chainId) => c.get('getClient')(chainId),
+            path: Path.join(c.get('basePath'), 'rpc/relay'),
+            ...(feePayer ? { feePayer } : {}),
+            ...(verifiedTokens
+                ? {
+                    resolveTokens: async (chainId) => {
+                        const snapshot = await VerifiedTokens.read(Db.get(c.get('dbCached')), chainId);
+                        return snapshot?.list.map((token) => token.address) ?? [];
+                    },
+                }
+                : {}),
+        });
+        return handler.fetch(c.req.raw);
+    });
+}
+//# sourceMappingURL=App.js.map

package/dist/apps/relay/App.js.map

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

package/dist/apps/relay/Sponsorships.d.ts

@@ -0,0 +1,107 @@
+import { type Address, type Client } from 'viem';
+import * as Db from '../../db/Db.js';
+import * as Tidx from '../../internal/Tidx.js';
+import * as Viem from '../../internal/Viem.js';
+/**
+ * Runs one finalization pass over pending sponsored transactions: rows with a
+ * receipt finalize with the actual fee (`gasUsed × effectiveGasPrice`, in
+ * fee-token base units); rows still unmined past the pending TTL fail, as do
+ * hash-less fill intents the TTL outlives. Rows whose receipt lookup errors
+ * persist past the error TTL fail so they cannot monopolize every batch.
+ *
+ * @param db - The database holding `sponsored_transactions`.
+ * @param options - Finalization options.
+ * @returns Counters for the pass.
+ */
+export declare function finalize(db: Db.Db, options: finalize.Options): Promise<finalize.Result>;
+export declare namespace finalize {
+    /** Options for {@link finalize}. */
+    type Options = {
+        /** Maximum pending rows processed per pass. @default 100 */
+        batchSize?: number | undefined;
+        /** Client resolver keyed by the row's chain id. */
+        getClient: (chainId: number) => Client;
+        /** Clock; injectable for tests. */
+        now?: (() => Date) | undefined;
+        /** Age after which an unmined sponsorship fails. @default 1 hour */
+        pendingTtlMs?: number | undefined;
+        /** Age after which repeated receipt lookup errors fail a row. @default 24 hours */
+        receiptErrorTtlMs?: number | undefined;
+    };
+    /** Counters returned by one finalization pass. */
+    type Result = {
+        /** Rows marked failed (unmined past the pending TTL). */
+        failed: number;
+        /** Rows finalized with an actual fee. */
+        finalized: number;
+        /** Rows left pending (unmined, or receipt lookup errored within the error TTL). */
+        pending: number;
+    };
+}
+/**
+ * Runs one reconciliation pass over pending fill intents (rows with no
+ * transaction hash): fetches the fee payer's recent on-chain transactions
+ * from TIDX, recomputes each candidate's fee-payer sign payload, and fills
+ * matching intents' hashes so the receipt pass can finalize them. Query or
+ * candidate errors leave intents for the next pass.
+ *
+ * @param db - The database holding `sponsored_transactions`.
+ * @param options - Reconciliation options.
+ * @returns Counters for the pass.
+ */
+export declare function reconcile(db: Db.Db, options: reconcile.Options): Promise<reconcile.Result>;
+export declare namespace reconcile {
+    /** Options for {@link reconcile}. */
+    type Options = {
+        /** Maximum intents considered per pass. @default 100 */
+        batchSize?: number | undefined;
+        /** Maximum on-chain candidates fetched per chain per pass. @default 500 */
+        candidateCap?: number | undefined;
+        /** How long failed intents remain reconciliation candidates. @default 24 hours */
+        failedIntentTtlMs?: number | undefined;
+        /** Fee payer address whose on-chain transactions are candidates. */
+        feePayer: Address;
+        /** Client resolver keyed by the intent's chain id. */
+        getClient: (chainId: number) => Client;
+        /** TIDX client resolver keyed by the intent's chain id. */
+        getTidx: (chainId: number) => Tidx.Client;
+        /** Lookback slack before the oldest intent's creation. @default 2 minutes */
+        skewMs?: number | undefined;
+    };
+    /** Counters returned by one reconciliation pass. */
+    type Result = {
+        /** Intents matched to an on-chain transaction. */
+        matched: number;
+        /** On-chain candidates inspected. */
+        scanned: number;
+    };
+}
+/**
+ * Builds a scheduled sponsorship finalizer bound to a database and RPC config.
+ * A host runtime drives {@link createFinalizer.Finalizer.tick} on a timer (a
+ * Cloudflare `scheduled` cron handler, a self-host `setInterval`, …); each
+ * tick reconciles fill intents (when `feePayer` + `tidx` are configured) and
+ * runs one {@link finalize} pass, with memoized per-chain clients.
+ */
+export declare function createFinalizer(options: createFinalizer.Options): createFinalizer.Finalizer;
+export declare namespace createFinalizer {
+    /** Options for {@link createFinalizer}. */
+    type Options = Pick<finalize.Options, 'batchSize' | 'now' | 'pendingTtlMs'> & {
+        /** Database holding sponsorship rows, or a factory resolved per tick (Workers/Hyperdrive). */
+        db: Db.Source;
+        /** Default chain id for the TIDX client resolver. */
+        defaultChainId?: Viem.ChainId | undefined;
+        /** Fee payer address whose on-chain transactions reconcile fill intents; omit to skip reconciliation. */
+        feePayer?: Address | undefined;
+        /** RPC options for the receipt-lookup clients. */
+        rpc?: Viem.getClient.Rpc | undefined;
+        /** TIDX query client options for intent reconciliation; omit to skip reconciliation. */
+        tidx?: Tidx.getClient.Tidx | undefined;
+    };
+    /** A scheduled sponsorship finalizer. */
+    type Finalizer = {
+        /** Runs one reconcile + finalize pass. */
+        tick(): Promise<finalize.Result & reconcile.Result>;
+    };
+}
+//# sourceMappingURL=Sponsorships.d.ts.map

package/dist/apps/relay/Sponsorships.d.ts.map

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