tapimo 0.0.2 → 0.1.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,9 @@ 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';
                 }, {
                     readonly description: 'Read webhook subscriptions.';
                     readonly scope: 'webhooks:read';
@@ -62,7 +65,7 @@ export declare function create(options: create.Options): import("hono/hono-base"
                         perMinute: number;
                     };
                 } | undefined;
-                scopes: readonly ("*" | "data:read" | "indexer:query" | "webhooks:read" | "webhooks:write")[];
+                scopes: readonly ("*" | "data:read" | "indexer:query" | "rpc-relay" | "webhooks:read" | "webhooks:write")[];
                 createdAt: string;
                 createdBy?: string | undefined;
                 expiresAt?: string | undefined;
@@ -78,7 +81,7 @@ export declare function create(options: create.Options): import("hono/hono-base"
                     rateLimits?: Record<string, {
                         perMinute: number;
                     }> | undefined;
-                    scopes: readonly ("*" | "data:read" | "indexer:query" | "webhooks:read" | "webhooks:write")[];
+                    scopes: readonly ("*" | "data:read" | "indexer:query" | "rpc-relay" | "webhooks:read" | "webhooks:write")[];
                     expiresAt?: string | undefined;
                     orgId?: string | undefined;
                 };
@@ -99,7 +102,7 @@ export declare function create(options: create.Options): import("hono/hono-base"
                             perMinute: number;
                         };
                     } | undefined;
-                    scopes: readonly ("*" | "data:read" | "indexer:query" | "webhooks:read" | "webhooks:write")[];
+                    scopes: readonly ("*" | "data:read" | "indexer:query" | "rpc-relay" | "webhooks:read" | "webhooks:write")[];
                     createdAt: string;
                     createdBy?: string | undefined;
                     expiresAt?: string | undefined;
@@ -149,22 +152,6 @@ export declare function create(options: create.Options): import("hono/hono-base"
 }, "/api-keys"> | import("hono/types").MergeSchemaPath<{
     "/": {
         $get: {
-            output: {
-                error: {
-                    code: "verified_tokens_not_enabled";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 404;
-            input: {
-                query: {
-                    chainId: string | string[];
-                };
-            };
-        } | {
             output: {
                 data: {
                     address: `0x${string}`;
@@ -191,14 +178,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 +201,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}`;
@@ -237,7 +224,7 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "verified_token_not_found";
+                    code: "assets_not_enabled";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -259,38 +246,19 @@ export declare function create(options: create.Options): import("hono/hono-base"
             };
         } | {
             output: {
-                error: {
-                    code: "duplicate_address";
-                    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: "duplicate_symbol";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
+                    id: string;
                 };
-                requestId: string;
+                version: string;
             };
             outputFormat: "json";
-            status: 409;
+            status: import("hono/utils/http-status").ContentfulStatusCode;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -306,14 +274,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: {
                 json: {
                     address: `0x${string}`;
@@ -329,14 +297,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;
+            status: 409;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -351,19 +319,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: "verified_token_not_found";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
                 };
-                version: string;
+                requestId: string;
             };
             outputFormat: "json";
-            status: import("hono/utils/http-status").ContentfulStatusCode;
+            status: 404;
             input: {
                 json: {
                     address: `0x${string}`;
@@ -379,14 +343,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 +370,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 +397,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[];
@@ -514,14 +478,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "version_mismatch";
+                    code: "verified_token_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 412;
+            status: 404;
             input: {
                 query: {
                     chainId: string | string[];
@@ -541,14 +505,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 +560,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 +567,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 +595,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}`;
@@ -685,15 +622,19 @@ export declare function create(options: create.Options): import("hono/hono-base"
             };
         } | {
             output: {
-                error: {
-                    code: "duplicate_address";
-                    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}`;
@@ -714,7 +655,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;
                 };
@@ -742,14 +683,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}`;
@@ -770,46 +711,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "verified_token_not_found";
                     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: 404;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -830,14 +739,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 +771,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 +791,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}`;
@@ -942,14 +851,14 @@ export declare function create(options: create.Options): import("hono/hono-base"
         } | {
             output: {
                 error: {
-                    code: "version_mismatch";
+                    code: "verified_token_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 412;
+            status: 404;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -962,14 +871,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 +903,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 +920,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 +940,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 +987,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 +1007,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 +1069,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 +1098,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 = {