tapimo 0.0.2 → 0.2.0

package/dist/admin/App.d.ts

@@ -1,8 +1,8 @@
 import { type RequestIdVariables } from 'hono/request-id';
-import * as ApiKeySource from '../ApiKeySource.js';
 import type * as Assets from '../Assets.js';
-import * as Response from '../internal/Response.js';
+import type * as Db from '../db/Db.js';
 import type * as Store from '../internal/Store.js';
+import * as Response from '../internal/Response.js';
 /** A verified admin identity, as returned by {@link create.Options.identify}. */
 export type Identity = {
     /** The admin's verified email, recorded as `createdBy` on every minted key. */
@@ -13,14 +13,14 @@ export type Environment = {
     Variables: RequestIdVariables & {
         /** Static-asset writer (e.g. the R2 icon bucket), when configured. */
         assets: create.Assets | undefined;
+        /** Authoritative Postgres store, or a per-request factory. Resolve at the leaf with `Db.get`. */
+        db: Db.Source;
+        /** KV state store backing API-key records (mint/list/revoke). */
+        kv: {
+            store: Store.State;
+        };
         /** The admin identity, or `null` when unauthenticated (gated routes reject). */
         identity: Identity | null;
-        /** The API-key source provisioned against (mint/list/revoke). */
-        source: ApiKeySource.Source;
-        /** Verified-token state store, when management is enabled. */
-        verifiedTokens: {
-            store: Store.State;
-        } | undefined;
     };
 };
 /** The admin portal Hono app. Inferred from {@link create}. */
@@ -36,6 +36,12 @@ export declare function create(options: create.Options): import("hono/hono-base"
                 }, {
                     readonly description: 'Run ad-hoc queries against the raw indexer passthrough.';
                     readonly scope: 'indexer:query';
+                }, {
+                    readonly description: 'Fill and submit transactions through the relay.';
+                    readonly scope: 'rpc-relay:read';
+                }, {
+                    readonly description: 'Sponsor transaction fees through the relay as the managed fee payer.';
+                    readonly scope: 'rpc-relay:sponsor';
                 }, {
                     readonly description: 'Read webhook subscriptions.';
                     readonly scope: 'webhooks:read';
@@ -50,6 +56,18 @@ export declare function create(options: create.Options): import("hono/hono-base"
         };
     };
 }, "/scopes"> | import("hono/types").MergeSchemaPath<{
+    "/backfill": {
+        $post: {
+            output: {
+                indexed: number;
+                scanned: number;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+            input: {};
+        };
+    };
+} & {
     "/": {
         $post: {
             output: {
@@ -57,12 +75,13 @@ export declare function create(options: create.Options): import("hono/hono-base"
                 id: string;
                 name?: string | undefined;
                 orgId: string;
+                projectId?: string | undefined;
                 rateLimits?: {
                     [x: string]: {
                         perMinute: number;
                     };
                 } | undefined;
-                scopes: readonly ("*" | "data:read" | "indexer:query" | "webhooks:read" | "webhooks:write")[];
+                scopes: readonly ("*" | "data:read" | "indexer:query" | "rpc-relay:read" | "rpc-relay:sponsor" | "webhooks:read" | "webhooks:write")[];
                 createdAt: string;
                 createdBy?: string | undefined;
                 expiresAt?: string | undefined;
@@ -75,10 +94,11 @@ export declare function create(options: create.Options): import("hono/hono-base"
                 json: {
                     environment?: "production" | "sandbox" | undefined;
                     name?: string | undefined;
+                    projectId?: string | undefined;
                     rateLimits?: Record<string, {
                         perMinute: number;
                     }> | undefined;
-                    scopes: readonly ("*" | "data:read" | "indexer:query" | "webhooks:read" | "webhooks:write")[];
+                    scopes: readonly ("*" | "data:read" | "indexer:query" | "rpc-relay:read" | "rpc-relay:sponsor" | "webhooks:read" | "webhooks:write")[];
                     expiresAt?: string | undefined;
                     orgId?: string | undefined;
                 };
@@ -94,12 +114,13 @@ export declare function create(options: create.Options): import("hono/hono-base"
                     id: string;
                     name?: string | undefined;
                     orgId: string;
+                    projectId?: string | undefined;
                     rateLimits?: {
                         [x: string]: {
                             perMinute: number;
                         };
                     } | undefined;
-                    scopes: readonly ("*" | "data:read" | "indexer:query" | "webhooks:read" | "webhooks:write")[];
+                    scopes: readonly ("*" | "data:read" | "indexer:query" | "rpc-relay:read" | "rpc-relay:sponsor" | "webhooks:read" | "webhooks:write")[];
                     createdAt: string;
                     createdBy?: string | undefined;
                     expiresAt?: string | undefined;
@@ -146,12 +167,12 @@ export declare function create(options: create.Options): import("hono/hono-base"
             };
         };
     };
-}, "/api-keys"> | import("hono/types").MergeSchemaPath<{
-    "/": {
-        $get: {
+} & {
+    "/:id": {
+        $patch: {
             output: {
                 error: {
-                    code: "verified_tokens_not_enabled";
+                    code: "not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -160,11 +181,50 @@ export declare function create(options: create.Options): import("hono/hono-base"
             outputFormat: "json";
             status: 404;
             input: {
-                query: {
-                    chainId: string | string[];
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    orgId?: string | undefined;
+                    projectId?: string | undefined;
                 };
             };
         } | {
+            output: {
+                environment: "production" | "sandbox";
+                id: string;
+                name?: string | undefined;
+                orgId: string;
+                projectId?: string | undefined;
+                rateLimits?: {
+                    [x: string]: {
+                        perMinute: number;
+                    };
+                } | undefined;
+                scopes: readonly ("*" | "data:read" | "indexer:query" | "rpc-relay:read" | "rpc-relay:sponsor" | "webhooks:read" | "webhooks:write")[];
+                createdAt: string;
+                createdBy?: string | undefined;
+                expiresAt?: string | undefined;
+                tokenLast4: string;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    orgId?: string | undefined;
+                    projectId?: string | undefined;
+                };
+            };
+        };
+    };
+}, "/api-keys"> | import("hono/types").MergeSchemaPath<{
+    "/": {
+        $get: {
             output: {
                 data: {
                     address: `0x${string}`;
@@ -191,14 +251,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         $post: {
             output: {
                 error: {
-                    code: "verified_tokens_not_enabled";
+                    code: string;
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 400 | 413 | 415;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -214,14 +274,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "assets_not_enabled";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 502;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -260,14 +320,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "duplicate_address";
+                    code: "assets_not_enabled";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 409;
+            status: 404;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -282,38 +342,19 @@ export declare function create(options: create.Options): import("hono/hono-base"
             };
         } | {
             output: {
-                error: {
-                    code: "duplicate_symbol";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 409;
-            input: {
-                json: {
+                data: {
                     address: `0x${string}`;
                     currency: string;
                     decimals: number;
                     logoUri?: string | undefined;
                     name: string;
                     symbol: string;
-                    chainId: unknown;
-                    logo?: string | undefined;
-                };
-            };
-        } | {
-            output: {
-                error: {
-                    code: "version_mismatch";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
+                    id: string;
                 };
-                requestId: string;
+                version: string;
             };
             outputFormat: "json";
-            status: 412;
+            status: import("hono/utils/http-status").ContentfulStatusCode;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -329,14 +370,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "duplicate_address";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 409;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -351,19 +392,15 @@ export declare function create(options: create.Options): import("hono/hono-base"
             };
         } | {
             output: {
-                data: {
-                    address: `0x${string}`;
-                    currency: string;
-                    decimals: number;
-                    logoUri?: string | undefined;
-                    name: string;
-                    symbol: string;
-                    id: string;
+                error: {
+                    code: "duplicate_symbol";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
                 };
-                version: string;
+                requestId: string;
             };
             outputFormat: "json";
-            status: import("hono/utils/http-status").ContentfulStatusCode;
+            status: 409;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -379,14 +416,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: string;
+                    code: "version_mismatch";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400 | 413 | 415;
+            status: 412;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -406,14 +443,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         $put: {
             output: {
                 error: {
-                    code: "verified_tokens_not_enabled";
+                    code: string;
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 400 | 413 | 415;
             input: {
                 query: {
                     chainId: string | string[];
@@ -433,14 +470,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "verified_token_not_found";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 502;
             input: {
                 query: {
                     chainId: string | string[];
@@ -460,14 +497,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "duplicate_address";
+                    code: "verified_token_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 409;
+            status: 404;
             input: {
                 query: {
                     chainId: string | string[];
@@ -487,7 +524,7 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "duplicate_symbol";
+                    code: "duplicate_address";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -514,14 +551,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "version_mismatch";
+                    code: "duplicate_symbol";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 412;
+            status: 409;
             input: {
                 query: {
                     chainId: string | string[];
@@ -541,14 +578,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "version_mismatch";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 412;
             input: {
                 query: {
                     chainId: string | string[];
@@ -596,33 +633,6 @@ export declare function create(options: create.Options): import("hono/hono-base"
                     }[];
                 };
             };
-        } | {
-            output: {
-                error: {
-                    code: string;
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 400 | 413 | 415;
-            input: {
-                query: {
-                    chainId: string | string[];
-                };
-            } & {
-                json: {
-                    tokens: {
-                        address: `0x${string}`;
-                        currency: string;
-                        decimals: number;
-                        logoUri?: string | undefined;
-                        name: string;
-                        symbol: string;
-                    }[];
-                };
-            };
         };
     };
 } & {
@@ -630,14 +640,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         $patch: {
             output: {
                 error: {
-                    code: "verified_tokens_not_enabled";
+                    code: string;
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 400 | 413 | 415;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -658,14 +668,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "verified_token_not_found";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 502;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -686,14 +696,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "duplicate_address";
+                    code: "verified_token_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 409;
+            status: 404;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -713,15 +723,19 @@ export declare function create(options: create.Options): import("hono/hono-base"
             };
         } | {
             output: {
-                error: {
-                    code: "duplicate_symbol";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
+                data: {
+                    address: `0x${string}`;
+                    currency: string;
+                    decimals: number;
+                    logoUri?: string | undefined;
+                    name: string;
+                    symbol: string;
+                    id: string;
                 };
-                requestId: string;
+                version: string;
             };
             outputFormat: "json";
-            status: 409;
+            status: import("hono/utils/http-status").ContentfulStatusCode;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -742,14 +756,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "version_mismatch";
+                    code: "duplicate_address";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 412;
+            status: 409;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -770,46 +784,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "duplicate_symbol";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query: {
-                    chainId: string | string[];
-                };
-            } & {
-                json: {
-                    currency?: string | undefined;
-                    decimals?: number | undefined;
-                    logoUri?: string | undefined;
-                    name?: string | undefined;
-                    symbol?: string | undefined;
-                };
-            };
-        } | {
-            output: {
-                data: {
-                    address: `0x${string}`;
-                    currency: string;
-                    decimals: number;
-                    logoUri?: string | undefined;
-                    name: string;
-                    symbol: string;
-                    id: string;
-                };
-                version: string;
-            };
-            outputFormat: "json";
-            status: import("hono/utils/http-status").ContentfulStatusCode;
+            status: 409;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -830,14 +812,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: string;
+                    code: "version_mismatch";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400 | 413 | 415;
+            status: 412;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -862,14 +844,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         $delete: {
             output: {
                 error: {
-                    code: "verified_tokens_not_enabled";
+                    code: string;
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 400 | 413 | 415;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -882,14 +864,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "verified_token_not_found";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 502;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -902,14 +884,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "duplicate_address";
+                    code: "verified_token_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 409;
+            status: 404;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -922,7 +904,7 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "duplicate_symbol";
+                    code: "duplicate_address";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -942,14 +924,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "version_mismatch";
+                    code: "duplicate_symbol";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 412;
+            status: 409;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -962,14 +944,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "version_mismatch";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 412;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -994,17 +976,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
                     chainId: string | string[];
                 };
             };
-        } | {
-            output: {
-                error: {
-                    code: string;
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 400 | 413 | 415;
+        };
+    };
+} & {
+    "/:address/logo": {
+        $get: {
+            output: ArrayBuffer;
+            outputFormat: "body";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1014,11 +993,7 @@ export declare function create(options: create.Options): import("hono/hono-base"
                     chainId: string | string[];
                 };
             };
-        };
-    };
-} & {
-    "/:address/logo": {
-        $get: {
+        } | {
             output: {
                 error: {
                     code: "logo_not_found";
@@ -1038,19 +1013,6 @@ export declare function create(options: create.Options): import("hono/hono-base"
                     chainId: string | string[];
                 };
             };
-        } | {
-            output: ArrayBuffer;
-            outputFormat: "body";
-            status: import("hono/utils/http-status").ContentfulStatusCode;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query: {
-                    chainId: string | string[];
-                };
-            };
         };
     };
 } & {
@@ -1098,14 +1060,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "payload_too_large";
+                    code: "unsupported_media_type";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 413;
+            status: 415;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1118,14 +1080,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "unsupported_media_type";
+                    code: "payload_too_large";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 415;
+            status: 413;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1180,16 +1142,24 @@ export declare namespace create {
     type Assets = Assets.Assets;
     /** Options for {@link create}. */
     type Options = {
-        /** API-key provisioning config (mirrors the API app's `apiKey` option). */
-        apiKey: {
-            /** Source to provision against (mint/list/revoke). */
-            source: ApiKeySource.Source;
-        };
         /**
          * Static-asset writer for logo uploads (shared with the main API's `assets`
          * loader) to enable `PUT /verified-tokens/:address/logo`; omit for `404`.
          */
         assets?: Assets | undefined;
+        /**
+         * Authoritative Postgres store shared with the main API (verified
+         * tokens). Pass a long-lived `Db.postgres(...)` singleton on Node, or a
+         * factory (`() => Db.postgres(...)`) on Workers.
+         */
+        db: Db.Source;
+        /**
+         * KV state store backing API-key records (shared with the main API's
+         * `kv` option), provisioned against by the `/api-keys` routes.
+         */
+        kv: {
+            store: Store.State;
+        };
         /**
          * Extracts the verified admin identity from a request, or `null` to deny.
          * Must only return an identity for an already-authenticated request (a
@@ -1201,14 +1171,6 @@ export declare namespace create {
          * `loginUrl`/`logoutUrl` are surfaced in `GET /config.json`.
          */
         ui?: Ui | false | undefined;
-        /**
-         * Verified-token management config (store shared with the main API's reads)
-         * to enable the `/verified-tokens` routes; omit to serve them as `404`.
-         */
-        verifiedTokens?: {
-            /** Verified-token state store (shared with the main API's reads). */
-            store: Store.State;
-        } | undefined;
     };
     /** Admin UI options surfaced to the SPA via `GET /config.json`. */
     type Ui = {