@qntx/wallet-engine 0.5.2 → 0.7.0

package/README.md

@@ -54,6 +54,27 @@ in-memory state.
   group-0 Nostr identity; pull before publish, per-entry last-writer-wins.
 - `engine.backup` — `BackupController` over an injected `CloudStore`.
 
+## React Native hosts
+
+The engine runs on the RN main runtime (Hermes) with no polyfills. Verified on 2026-11-02 in an
+iOS simulator Release build and on 2026-11-03 in an Android API 30 emulator Release build (both
+RN 0.88.0, Expo 58, Hermes), with and without `react-native-quick-crypto`'s `install()`, using a
+hardware-factor wallet: engine
+creation, the gateway's `/v1/networks`, a Sepolia balance read, a send request prepared and
+rejected, signet and Solana devnet reads through the gateway, `payments.parse`, and a lock that
+invalidates open requests.
+
+What the host must provide:
+
+- `random`: a CSPRNG, injected as an option. Hermes has no `crypto.getRandomValues`, so use a native
+  source such as `react-native-quick-crypto`'s `randomBytes`:
+  `random: (n) => new Uint8Array(randomBytes(n))`.
+- Nothing else. `globalThis.crypto`, `crypto.subtle` and `Buffer` are all absent in that run and
+  not needed; `fetch`, `TextEncoder`, `URL`, `AbortSignal.timeout` and `structuredClone` are built in.
+
+A host that already calls `install()` from `react-native-quick-crypto` (as Meowl does) also works;
+the same smoke passes with those globals installed.
+
 ## License
 
 MIT OR Apache-2.0

package/dist/contract-CEsgLme3.mjs

@@ -0,0 +1,277 @@
+import * as z from "zod/mini";
+// src/gateway/contract/endpoint.ts
+/** One gateway route: its verb, versioned path template, and request/response schemas. */
+function endpoint(method, path, request, response) {
+	return {
+		method,
+		path,
+		request,
+		response
+	};
+}
+/** `value` typed by `schema`, or `undefined` when it does not satisfy it. */
+function parseWith(schema, value) {
+	const result = z.safeParse(schema, value);
+	return result.success ? result.data : void 0;
+}
+/** Whether `value` satisfies `schema` — lets consumers validate without importing zod. */
+function accepts(schema, value) {
+	return z.safeParse(schema, value).success;
+}
+// src/gateway/contract/rpc.ts
+/** One JSON-RPC call plus nothing else: batches may carry at most this many entries. */
+const RPC_BATCH_MAX = 20;
+/** Read-only EVM methods plus `eth_sendRawTransaction`. Anything not listed is rejected. */
+const EVM_RPC_METHODS = [
+	"eth_blobBaseFee",
+	"eth_blockNumber",
+	"eth_call",
+	"eth_chainId",
+	"eth_createAccessList",
+	"eth_estimateGas",
+	"eth_feeHistory",
+	"eth_gasPrice",
+	"eth_getBalance",
+	"eth_getBlockByHash",
+	"eth_getBlockByNumber",
+	"eth_getBlockReceipts",
+	"eth_getBlockTransactionCountByHash",
+	"eth_getBlockTransactionCountByNumber",
+	"eth_getCode",
+	"eth_getProof",
+	"eth_getStorageAt",
+	"eth_getTransactionByBlockHashAndIndex",
+	"eth_getTransactionByBlockNumberAndIndex",
+	"eth_getTransactionByHash",
+	"eth_getTransactionCount",
+	"eth_getTransactionReceipt",
+	"eth_maxPriorityFeePerGas",
+	"eth_sendRawTransaction",
+	"net_version",
+	"web3_clientVersion"
+];
+/** Read-only Solana methods plus `sendTransaction`. Anything not listed is rejected. */
+const SOLANA_RPC_METHODS = [
+	"getAccountInfo",
+	"getBalance",
+	"getBlock",
+	"getBlockHeight",
+	"getBlockTime",
+	"getEpochInfo",
+	"getFeeForMessage",
+	"getGenesisHash",
+	"getLatestBlockhash",
+	"getMinimumBalanceForRentExemption",
+	"getMultipleAccounts",
+	"getRecentPrioritizationFees",
+	"getSignatureStatuses",
+	"getSignaturesForAddress",
+	"getSlot",
+	"getTokenAccountBalance",
+	"getTokenAccountsByOwner",
+	"getTokenSupply",
+	"getTransaction",
+	"getVersion",
+	"isBlockhashValid",
+	"sendTransaction",
+	"simulateTransaction"
+];
+const jsonRpcId = z.union([
+	z.string(),
+	z.number(),
+	z.null()
+]);
+const jsonRpcParams = z.optional(z.union([z.array(z.unknown()), z.record(z.string(), z.unknown())]));
+const callSchema = (method) => z.object({
+	jsonrpc: z.literal("2.0"),
+	id: jsonRpcId,
+	method,
+	params: jsonRpcParams
+});
+const bodySchema = (call) => z.union([call, z.array(call).check(z.minLength(1), z.maxLength(20))]);
+/** Method-agnostic wire shape of a call or batch (the gateway narrows by family). */
+const rpcRequest = bodySchema(callSchema(z.string()));
+const evmRpcRequest = bodySchema(callSchema(z.enum(EVM_RPC_METHODS)));
+const solanaRpcRequest = bodySchema(callSchema(z.enum(SOLANA_RPC_METHODS)));
+const successResponse = z.object({
+	jsonrpc: z.literal("2.0"),
+	id: jsonRpcId,
+	result: z.unknown()
+});
+const errorResponse = z.object({
+	jsonrpc: z.literal("2.0"),
+	id: jsonRpcId,
+	error: z.object({
+		code: z.int(),
+		message: z.string(),
+		data: z.optional(z.unknown())
+	})
+});
+const jsonRpcResponse = z.union([successResponse, errorResponse]);
+const rpcResponse = z.union([jsonRpcResponse, z.array(jsonRpcResponse)]);
+const rpc = endpoint("POST", "/v1/rpc/:caip2", rpcRequest, rpcResponse);
+/** The JSON-RPC URL path for one network. */
+const rpcPath = (caip2) => rpc.path.replace(":caip2", caip2);
+// src/gateway/contract/primitives.ts
+const INSTALL_ID_HEADER = "x-install-id";
+const PROVIDERS_HEADER = "x-gateway-providers";
+/** 128 random bits as lowercase hex — generated once per install, unrelated to wallet secrets. */
+const installId = z.string().check(z.regex(/^[0-9a-f]{32}$/));
+/** CAIP-2 chain id: `namespace:reference`. */
+const caip2 = z.string().check(z.regex(/^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$/));
+const GATEWAY_ERRORS = [
+	"invalid-request",
+	"unknown-network",
+	"not-found",
+	"rate-limited",
+	"unavailable",
+	"internal"
+];
+const gatewayError = z.object({ error: z.enum(GATEWAY_ERRORS) });
+// src/gateway/contract/health.ts
+const healthRequest = z.undefined();
+const healthResponse = z.object({ status: z.literal("ok") });
+const health = endpoint("GET", "/v1/health", healthRequest, healthResponse);
+// src/gateway/contract/esplora.ts
+const HEX64 = "[0-9a-f]{64}";
+/** The Esplora surface the engine uses; every other path is rejected. */
+const ESPLORA_ROUTES = [
+	{
+		method: "GET",
+		pattern: /^\/block-height\/\d{1,10}$/
+	},
+	{
+		method: "GET",
+		pattern: /^\/fee-estimates$/
+	},
+	{
+		method: "GET",
+		pattern: new RegExp(`^/scripthash/${HEX64}/txs$`)
+	},
+	{
+		method: "GET",
+		pattern: new RegExp(`^/scripthash/${HEX64}/utxo$`)
+	},
+	{
+		method: "GET",
+		pattern: new RegExp(`^/tx/${HEX64}/hex$`)
+	},
+	{
+		method: "GET",
+		pattern: new RegExp(`^/tx/${HEX64}/status$`)
+	},
+	{
+		method: "POST",
+		pattern: /^\/tx$/
+	}
+];
+/** `path` is the Esplora path after `/v1/esplora/:caip2`, with a leading slash and no query. */
+const esploraPathAllowed = (method, path) => ESPLORA_ROUTES.some((route) => route.method === method && route.pattern.test(path));
+const esploraGet = endpoint("GET", "/v1/esplora/:caip2/*", z.undefined(), z.unknown());
+/** The Esplora base path for one network; allow-listed paths are appended to it. */
+const esploraBasePath = (caip2) => esploraGet.path.replace(":caip2", caip2).replace(/\/\*$/, "");
+const esploraPost = endpoint("POST", "/v1/esplora/:caip2/tx", z.string(), z.string());
+// src/networks/registry.ts
+const entry = (chainId, name, symbol, testnet, _source) => ({
+	id: `eip155:${chainId}`,
+	chainId,
+	name,
+	symbol,
+	decimals: 18,
+	testnet,
+	family: "evm",
+	multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11"
+});
+const NETWORKS = [
+	entry(1, "Ethereum", "ETH", false, "https://ethereum.org/en/developers/docs/networks/"),
+	entry(8453, "Base", "ETH", false, "https://docs.base.org/docs/network-information"),
+	entry(42161, "Arbitrum One", "ETH", false, "https://docs.arbitrum.io/for-devs/dev-tools-and-resources/chain-info"),
+	entry(10, "OP Mainnet", "ETH", false, "https://docs.optimism.io/chain/networks"),
+	entry(137, "Polygon", "POL", false, "https://docs.polygon.technology/pos/reference/rpc-endpoints/"),
+	entry(56, "BNB Smart Chain", "BNB", false, "https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/"),
+	entry(999, "HyperEVM", "HYPE", false, "https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm"),
+	entry(43114, "Avalanche C-Chain", "AVAX", false, "https://build.avax.network/docs/tooling/rpc-providers"),
+	entry(11155111, "Sepolia", "ETH", true, "https://ethereum.org/en/developers/docs/networks/"),
+	entry(84532, "Base Sepolia", "ETH", true, "https://docs.base.org/docs/network-information"),
+	entry(421614, "Arbitrum Sepolia", "ETH", true, "https://docs.arbitrum.io/for-devs/dev-tools-and-resources/chain-info"),
+	entry(11155420, "OP Sepolia", "ETH", true, "https://docs.optimism.io/chain/networks"),
+	entry(80002, "Polygon Amoy", "POL", true, "https://docs.polygon.technology/pos/reference/rpc-endpoints/"),
+	entry(97, "BNB Smart Chain Testnet", "tBNB", true, "https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/"),
+	entry(998, "HyperEVM Testnet", "HYPE", true, "https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm"),
+	entry(43113, "Avalanche Fuji", "AVAX", true, "https://build.avax.network/docs/tooling/rpc-providers")
+];
+const networkById = (id) => [
+	...NETWORKS,
+	...SOLANA_NETWORKS,
+	...BITCOIN_NETWORKS
+].find((n) => n.id === id);
+const BITCOIN_NETWORKS = [
+	{
+		id: "bip122:000000000019d6689c085ae165831e93",
+		chainId: 0,
+		name: "Bitcoin",
+		symbol: "BTC",
+		decimals: 8,
+		testnet: false,
+		family: "bitcoin",
+		genesisHash: "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f"
+	},
+	{
+		id: "bip122:00000000da84f2bafbbc53dee25a72ae",
+		chainId: 0,
+		name: "Bitcoin Testnet4",
+		symbol: "tBTC",
+		decimals: 8,
+		testnet: true,
+		family: "bitcoin",
+		genesisHash: "00000000da84f2bafbbc53dee25a72ae507ff4914b867c565be350b0da8bf043"
+	},
+	{
+		id: "bip122:00000008819873e925422c1ff0f99f7c",
+		chainId: 0,
+		name: "Bitcoin Signet",
+		symbol: "sBTC",
+		decimals: 8,
+		testnet: true,
+		family: "bitcoin",
+		genesisHash: "00000008819873e925422c1ff0f99f7cc9bbb232af63a077a480a3633bee1ef6"
+	},
+	{
+		id: "bip122:0f9188f13cb7b2c71f2a335e3a4fc328",
+		chainId: 0,
+		name: "Bitcoin Regtest",
+		symbol: "rBTC",
+		decimals: 8,
+		testnet: true,
+		family: "bitcoin",
+		genesisHash: "0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206"
+	}
+];
+const SOLANA_NETWORKS = [{
+	id: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+	chainId: 0,
+	name: "Solana",
+	symbol: "SOL",
+	decimals: 9,
+	testnet: false,
+	family: "solana",
+	genesisHash: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d"
+}, {
+	id: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+	chainId: 0,
+	name: "Solana Devnet",
+	symbol: "SOL",
+	decimals: 9,
+	testnet: true,
+	family: "solana",
+	genesisHash: "EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG"
+}];
+// src/gateway/contract/served.ts
+const servedNetworksRequest = z.undefined();
+/** The networks the gateway actually serves, in its configured order. */
+const servedNetworksResponse = z.object({ networks: z.array(caip2) });
+const servedNetworks = endpoint("GET", "/v1/networks", servedNetworksRequest, servedNetworksResponse);
+const networksPath = servedNetworks.path;
+export { rpcPath as A, EVM_RPC_METHODS as C, jsonRpcId as D, evmRpcRequest as E, endpoint as F, parseWith as I, rpcResponse as M, solanaRpcRequest as N, jsonRpcResponse as O, accepts as P, installId as S, SOLANA_RPC_METHODS as T, GATEWAY_ERRORS as _, BITCOIN_NETWORKS as a, caip2 as b, networkById as c, esploraGet as d, esploraPathAllowed as f, healthResponse as g, healthRequest as h, servedNetworksResponse as i, rpcRequest as j, rpc as k, ESPLORA_ROUTES as l, health as m, servedNetworks as n, NETWORKS as o, esploraPost as p, servedNetworksRequest as r, SOLANA_NETWORKS as s, networksPath as t, esploraBasePath as u, INSTALL_ID_HEADER as v, RPC_BATCH_MAX as w, gatewayError as x, PROVIDERS_HEADER as y };
+
+//# sourceMappingURL=contract-CEsgLme3.mjs.map

package/dist/contract-CEsgLme3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-CEsgLme3.mjs","names":[],"sources":["../src/gateway/contract/endpoint.ts","../src/gateway/contract/rpc.ts","../src/gateway/contract/primitives.ts","../src/gateway/contract/health.ts","../src/gateway/contract/esplora.ts","../src/networks/registry.ts","../src/gateway/contract/served.ts"],"sourcesContent":["import * as z from \"zod/mini\";\n\nexport type HttpMethod = \"GET\" | \"POST\" | \"DELETE\";\n\nexport type Endpoint<Req extends z.ZodMiniType, Res extends z.ZodMiniType> = {\n  readonly method: HttpMethod;\n  readonly path: string;\n  readonly request: Req;\n  readonly response: Res;\n};\n\n/** One gateway route: its verb, versioned path template, and request/response schemas. */\nexport function endpoint<Req extends z.ZodMiniType, Res extends z.ZodMiniType>(\n  method: HttpMethod,\n  path: `/v1/${string}`,\n  request: Req,\n  response: Res,\n): Endpoint<Req, Res> {\n  return { method, path, request, response };\n}\n\n/** `value` typed by `schema`, or `undefined` when it does not satisfy it. */\nexport function parseWith<S extends z.ZodMiniType>(\n  schema: S,\n  value: unknown,\n): z.output<S> | undefined {\n  const result = z.safeParse(schema, value);\n  return result.success ? result.data : undefined;\n}\n\n/** Whether `value` satisfies `schema` — lets consumers validate without importing zod. */\nexport function accepts(schema: z.ZodMiniType, value: unknown): boolean {\n  return z.safeParse(schema, value).success;\n}\n","import * as z from \"zod/mini\";\n\nimport { endpoint } from \"./endpoint.ts\";\n\n/** One JSON-RPC call plus nothing else: batches may carry at most this many entries. */\nexport const RPC_BATCH_MAX = 20;\n\n/** Read-only EVM methods plus `eth_sendRawTransaction`. Anything not listed is rejected. */\nexport const EVM_RPC_METHODS = [\n  \"eth_blobBaseFee\",\n  \"eth_blockNumber\",\n  \"eth_call\",\n  \"eth_chainId\",\n  \"eth_createAccessList\",\n  \"eth_estimateGas\",\n  \"eth_feeHistory\",\n  \"eth_gasPrice\",\n  \"eth_getBalance\",\n  \"eth_getBlockByHash\",\n  \"eth_getBlockByNumber\",\n  \"eth_getBlockReceipts\",\n  \"eth_getBlockTransactionCountByHash\",\n  \"eth_getBlockTransactionCountByNumber\",\n  \"eth_getCode\",\n  \"eth_getProof\",\n  \"eth_getStorageAt\",\n  \"eth_getTransactionByBlockHashAndIndex\",\n  \"eth_getTransactionByBlockNumberAndIndex\",\n  \"eth_getTransactionByHash\",\n  \"eth_getTransactionCount\",\n  \"eth_getTransactionReceipt\",\n  \"eth_maxPriorityFeePerGas\",\n  \"eth_sendRawTransaction\",\n  \"net_version\",\n  \"web3_clientVersion\",\n] as const;\n\n/** Read-only Solana methods plus `sendTransaction`. Anything not listed is rejected. */\nexport const SOLANA_RPC_METHODS = [\n  \"getAccountInfo\",\n  \"getBalance\",\n  \"getBlock\",\n  \"getBlockHeight\",\n  \"getBlockTime\",\n  \"getEpochInfo\",\n  \"getFeeForMessage\",\n  \"getGenesisHash\",\n  \"getLatestBlockhash\",\n  \"getMinimumBalanceForRentExemption\",\n  \"getMultipleAccounts\",\n  \"getRecentPrioritizationFees\",\n  \"getSignatureStatuses\",\n  \"getSignaturesForAddress\",\n  \"getSlot\",\n  \"getTokenAccountBalance\",\n  \"getTokenAccountsByOwner\",\n  \"getTokenSupply\",\n  \"getTransaction\",\n  \"getVersion\",\n  \"isBlockhashValid\",\n  \"sendTransaction\",\n  \"simulateTransaction\",\n] as const;\n\nexport type EvmRpcMethod = (typeof EVM_RPC_METHODS)[number];\nexport type SolanaRpcMethod = (typeof SOLANA_RPC_METHODS)[number];\n\nexport const jsonRpcId = z.union([z.string(), z.number(), z.null()]);\n\nconst jsonRpcParams = z.optional(\n  z.union([z.array(z.unknown()), z.record(z.string(), z.unknown())]),\n);\n\nconst callSchema = <M extends z.ZodMiniType<string>>(method: M) =>\n  z.object({ jsonrpc: z.literal(\"2.0\"), id: jsonRpcId, method, params: jsonRpcParams });\n\nconst bodySchema = <C extends z.ZodMiniType>(call: C) =>\n  z.union([call, z.array(call).check(z.minLength(1), z.maxLength(RPC_BATCH_MAX))]);\n\n/** Method-agnostic wire shape of a call or batch (the gateway narrows by family). */\nexport const rpcRequest = bodySchema(callSchema(z.string()));\n\nexport const evmRpcRequest = bodySchema(callSchema(z.enum(EVM_RPC_METHODS)));\nexport const solanaRpcRequest = bodySchema(callSchema(z.enum(SOLANA_RPC_METHODS)));\n\nconst successResponse = z.object({\n  jsonrpc: z.literal(\"2.0\"),\n  id: jsonRpcId,\n  result: z.unknown(),\n});\nconst errorResponse = z.object({\n  jsonrpc: z.literal(\"2.0\"),\n  id: jsonRpcId,\n  error: z.object({ code: z.int(), message: z.string(), data: z.optional(z.unknown()) }),\n});\n\nexport const jsonRpcResponse = z.union([successResponse, errorResponse]);\nexport const rpcResponse = z.union([jsonRpcResponse, z.array(jsonRpcResponse)]);\n\nexport const rpc = endpoint(\"POST\", \"/v1/rpc/:caip2\", rpcRequest, rpcResponse);\n\n/** The JSON-RPC URL path for one network. */\nexport const rpcPath = (caip2: string): string => rpc.path.replace(\":caip2\", caip2);\n","import * as z from \"zod/mini\";\n\nexport const INSTALL_ID_HEADER = \"x-install-id\";\nexport const PROVIDERS_HEADER = \"x-gateway-providers\";\n\n/** 128 random bits as lowercase hex — generated once per install, unrelated to wallet secrets. */\nexport const installId = z.string().check(z.regex(/^[0-9a-f]{32}$/));\n\n/** CAIP-2 chain id: `namespace:reference`. */\nexport const caip2 = z.string().check(z.regex(/^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$/));\n\nexport type Caip2 = z.infer<typeof caip2>;\nexport type InstallId = z.infer<typeof installId>;\n\nexport const GATEWAY_ERRORS = [\n  \"invalid-request\",\n  \"unknown-network\",\n  \"not-found\",\n  \"rate-limited\",\n  \"unavailable\",\n  \"internal\",\n] as const;\n\nexport const gatewayError = z.object({ error: z.enum(GATEWAY_ERRORS) });\n\nexport type GatewayErrorCode = (typeof GATEWAY_ERRORS)[number];\n","import * as z from \"zod/mini\";\n\nimport { endpoint } from \"./endpoint.ts\";\n\nexport const healthRequest = z.undefined();\nexport const healthResponse = z.object({ status: z.literal(\"ok\") });\n\nexport const health = endpoint(\"GET\", \"/v1/health\", healthRequest, healthResponse);\n","import * as z from \"zod/mini\";\n\nimport { endpoint } from \"./endpoint.ts\";\n\nconst HEX64 = \"[0-9a-f]{64}\";\n\ntype EsploraRoute = { readonly method: \"GET\" | \"POST\"; readonly pattern: RegExp };\n\n/** The Esplora surface the engine uses; every other path is rejected. */\nexport const ESPLORA_ROUTES: ReadonlyArray<EsploraRoute> = [\n  { method: \"GET\", pattern: /^\\/block-height\\/\\d{1,10}$/ },\n  { method: \"GET\", pattern: /^\\/fee-estimates$/ },\n  { method: \"GET\", pattern: new RegExp(`^/scripthash/${HEX64}/txs$`) },\n  { method: \"GET\", pattern: new RegExp(`^/scripthash/${HEX64}/utxo$`) },\n  { method: \"GET\", pattern: new RegExp(`^/tx/${HEX64}/hex$`) },\n  { method: \"GET\", pattern: new RegExp(`^/tx/${HEX64}/status$`) },\n  { method: \"POST\", pattern: /^\\/tx$/ },\n];\n\n/** `path` is the Esplora path after `/v1/esplora/:caip2`, with a leading slash and no query. */\nexport const esploraPathAllowed = (method: string, path: string): boolean =>\n  ESPLORA_ROUTES.some((route) => route.method === method && route.pattern.test(path));\n\nexport const esploraGet = endpoint(\"GET\", \"/v1/esplora/:caip2/*\", z.undefined(), z.unknown());\n\n/** The Esplora base path for one network; allow-listed paths are appended to it. */\nexport const esploraBasePath = (caip2: string): string =>\n  esploraGet.path.replace(\":caip2\", caip2).replace(/\\/\\*$/, \"\");\nexport const esploraPost = endpoint(\"POST\", \"/v1/esplora/:caip2/tx\", z.string(), z.string());\n","/**\n * Built-in EVM network registry: the 8 mainnets from chains.mdx plus their main testnets. Each\n * chain id was checked against the chain's official documentation (source URL per entry).\n * Signing-time chainId always comes from this table, never from an RPC endpoint.\n */\n\nexport type NetworkInfo = {\n  readonly id: string; // CAIP-2 eip155:<chainId>\n  readonly chainId: number;\n  readonly name: string;\n  readonly symbol: string;\n  readonly multicall3?: string;\n  /** CAIP-2 family — `solana:<ref>` networks are validated against genesis-hash, not chainId. */\n  readonly family: \"evm\" | \"solana\" | \"bitcoin\";\n  readonly genesisHash?: string;\n  readonly decimals: number;\n  readonly testnet: boolean;\n};\n\nconst entry = (\n  chainId: number,\n  name: string,\n  symbol: string,\n  testnet: boolean,\n  _source: string,\n): NetworkInfo => ({\n  id: `eip155:${chainId}`,\n  chainId,\n  name,\n  symbol,\n  decimals: 18,\n  testnet,\n  family: \"evm\",\n  // Canonical Multicall3 — https://github.com/mds1/multicall3 deployments (all entries below).\n  multicall3: \"0xcA11bde05977b3631167028862bE2a173976CA11\",\n});\n\nexport const NETWORKS: ReadonlyArray<NetworkInfo> = [\n  // https://chainlist.org + https://ethereum.org (Ethereum mainnet chainId 1)\n  entry(1, \"Ethereum\", \"ETH\", false, \"https://ethereum.org/en/developers/docs/networks/\"),\n  // https://docs.base.org — Base Sepolia 84532\n  entry(8453, \"Base\", \"ETH\", false, \"https://docs.base.org/docs/network-information\"),\n  // https://docs.arbitrum.io — Arbitrum Sepolia 421614\n  entry(\n    42161,\n    \"Arbitrum One\",\n    \"ETH\",\n    false,\n    \"https://docs.arbitrum.io/for-devs/dev-tools-and-resources/chain-info\",\n  ),\n  // https://docs.optimism.io — OP Sepolia 11155420\n  entry(10, \"OP Mainnet\", \"ETH\", false, \"https://docs.optimism.io/chain/networks\"),\n  // https://docs.polygon.technology — Amoy 80002\n  entry(\n    137,\n    \"Polygon\",\n    \"POL\",\n    false,\n    \"https://docs.polygon.technology/pos/reference/rpc-endpoints/\",\n  ),\n  // https://docs.bnbchain.org — BSC testnet 97\n  entry(\n    56,\n    \"BNB Smart Chain\",\n    \"BNB\",\n    false,\n    \"https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/\",\n  ),\n  // https://hyperliquid.gitbook.io — HyperEVM testnet 998\n  entry(\n    999,\n    \"HyperEVM\",\n    \"HYPE\",\n    false,\n    \"https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm\",\n  ),\n  // https://build.avax.network — Fuji 43113\n  entry(\n    43114,\n    \"Avalanche C-Chain\",\n    \"AVAX\",\n    false,\n    \"https://build.avax.network/docs/tooling/rpc-providers\",\n  ),\n  entry(11155111, \"Sepolia\", \"ETH\", true, \"https://ethereum.org/en/developers/docs/networks/\"),\n  entry(84532, \"Base Sepolia\", \"ETH\", true, \"https://docs.base.org/docs/network-information\"),\n  entry(\n    421614,\n    \"Arbitrum Sepolia\",\n    \"ETH\",\n    true,\n    \"https://docs.arbitrum.io/for-devs/dev-tools-and-resources/chain-info\",\n  ),\n  entry(11155420, \"OP Sepolia\", \"ETH\", true, \"https://docs.optimism.io/chain/networks\"),\n  entry(\n    80002,\n    \"Polygon Amoy\",\n    \"POL\",\n    true,\n    \"https://docs.polygon.technology/pos/reference/rpc-endpoints/\",\n  ),\n  entry(\n    97,\n    \"BNB Smart Chain Testnet\",\n    \"tBNB\",\n    true,\n    \"https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/\",\n  ),\n  entry(\n    998,\n    \"HyperEVM Testnet\",\n    \"HYPE\",\n    true,\n    \"https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm\",\n  ),\n  entry(\n    43113,\n    \"Avalanche Fuji\",\n    \"AVAX\",\n    true,\n    \"https://build.avax.network/docs/tooling/rpc-providers\",\n  ),\n];\n\nexport const networkById = (id: string): NetworkInfo | undefined =>\n  [...NETWORKS, ...SOLANA_NETWORKS, ...BITCOIN_NETWORKS].find((n) => n.id === id);\nexport const BITCOIN_NETWORKS: ReadonlyArray<NetworkInfo> = [\n  {\n    id: \"bip122:000000000019d6689c085ae165831e93\",\n    chainId: 0,\n    name: \"Bitcoin\",\n    symbol: \"BTC\",\n    decimals: 8,\n    testnet: false,\n    family: \"bitcoin\",\n    genesisHash: \"000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f\",\n  },\n  {\n    id: \"bip122:00000000da84f2bafbbc53dee25a72ae\",\n    chainId: 0,\n    name: \"Bitcoin Testnet4\",\n    symbol: \"tBTC\",\n    decimals: 8,\n    testnet: true,\n    family: \"bitcoin\",\n    genesisHash: \"00000000da84f2bafbbc53dee25a72ae507ff4914b867c565be350b0da8bf043\",\n  },\n  {\n    id: \"bip122:00000008819873e925422c1ff0f99f7c\",\n    chainId: 0,\n    name: \"Bitcoin Signet\",\n    symbol: \"sBTC\",\n    decimals: 8,\n    testnet: true,\n    family: \"bitcoin\",\n    genesisHash: \"00000008819873e925422c1ff0f99f7cc9bbb232af63a077a480a3633bee1ef6\",\n  },\n  {\n    id: \"bip122:0f9188f13cb7b2c71f2a335e3a4fc328\",\n    chainId: 0,\n    name: \"Bitcoin Regtest\",\n    symbol: \"rBTC\",\n    decimals: 8,\n    testnet: true,\n    family: \"bitcoin\",\n    genesisHash: \"0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206\",\n  },\n];\n\nexport const SOLANA_NETWORKS: ReadonlyArray<NetworkInfo> = [\n  {\n    id: \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\",\n    chainId: 0,\n    name: \"Solana\",\n    symbol: \"SOL\",\n    decimals: 9,\n    testnet: false,\n    family: \"solana\",\n    // https://solana.com/docs/references/clusters (mainnet genesis hash)\n    genesisHash: \"5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d\",\n  },\n  {\n    id: \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n    chainId: 0,\n    name: \"Solana Devnet\",\n    symbol: \"SOL\",\n    decimals: 9,\n    testnet: true,\n    family: \"solana\",\n    genesisHash: \"EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG\",\n  },\n];\n","import * as z from \"zod/mini\";\n\nimport { endpoint } from \"./endpoint.ts\";\nimport { caip2 } from \"./primitives.ts\";\n\nexport const servedNetworksRequest = z.undefined();\n/** The networks the gateway actually serves, in its configured order. */\nexport const servedNetworksResponse = z.object({ networks: z.array(caip2) });\n\nexport const servedNetworks = endpoint(\n  \"GET\",\n  \"/v1/networks\",\n  servedNetworksRequest,\n  servedNetworksResponse,\n);\n\nexport const networksPath: string = servedNetworks.path;\n"],"mappings":"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"}

package/dist/gateway-contract.d.mts

@@ -0,0 +1,285 @@
+import { a as networkById, i as SOLANA_NETWORKS, n as NETWORKS, r as NetworkInfo, t as BITCOIN_NETWORKS } from "./registry-LcFSPrE1.mjs";
+import * as z from "zod/mini";
+export declare const INSTALL_ID_HEADER = "x-install-id";
+export declare const PROVIDERS_HEADER = "x-gateway-providers";
+/** 128 random bits as lowercase hex — generated once per install, unrelated to wallet secrets. */
+export declare const installId: z.ZodMiniString<string>;
+/** CAIP-2 chain id: `namespace:reference`. */
+export declare const caip2: z.ZodMiniString<string>;
+export type Caip2 = z.infer<typeof caip2>;
+export type InstallId = z.infer<typeof installId>;
+export declare const GATEWAY_ERRORS: readonly ["invalid-request", "unknown-network", "not-found", "rate-limited", "unavailable", "internal"];
+export declare const gatewayError: z.ZodMiniObject<{
+  error: z.ZodMiniEnum<{
+    internal: "internal";
+    "invalid-request": "invalid-request";
+    "not-found": "not-found";
+    "rate-limited": "rate-limited";
+    unavailable: "unavailable";
+    "unknown-network": "unknown-network";
+  }>;
+}, z.core.$strip>;
+export type GatewayErrorCode = (typeof GATEWAY_ERRORS)[number];
+export type HttpMethod = "GET" | "POST" | "DELETE";
+export type Endpoint<Req extends z.ZodMiniType, Res extends z.ZodMiniType> = {
+  readonly method: HttpMethod;
+  readonly path: string;
+  readonly request: Req;
+  readonly response: Res;
+};
+/** One gateway route: its verb, versioned path template, and request/response schemas. */
+export declare function endpoint<Req extends z.ZodMiniType, Res extends z.ZodMiniType>(method: HttpMethod, path: `/v1/${string}`, request: Req, response: Res): Endpoint<Req, Res>;
+/** `value` typed by `schema`, or `undefined` when it does not satisfy it. */
+export declare function parseWith<S extends z.ZodMiniType>(schema: S, value: unknown): z.output<S> | undefined;
+/** Whether `value` satisfies `schema` — lets consumers validate without importing zod. */
+export declare function accepts(schema: z.ZodMiniType, value: unknown): boolean;
+export declare const healthRequest: z.ZodMiniUndefined;
+export declare const healthResponse: z.ZodMiniObject<{
+  status: z.ZodMiniLiteral<"ok">;
+}, z.core.$strip>;
+export declare const health: Endpoint<z.ZodMiniUndefined, z.ZodMiniObject<{
+  status: z.ZodMiniLiteral<"ok">;
+}, z.core.$strip>>;
+/** One JSON-RPC call plus nothing else: batches may carry at most this many entries. */
+export declare const RPC_BATCH_MAX = 20;
+/** Read-only EVM methods plus `eth_sendRawTransaction`. Anything not listed is rejected. */
+export declare const EVM_RPC_METHODS: readonly ["eth_blobBaseFee", "eth_blockNumber", "eth_call", "eth_chainId", "eth_createAccessList", "eth_estimateGas", "eth_feeHistory", "eth_gasPrice", "eth_getBalance", "eth_getBlockByHash", "eth_getBlockByNumber", "eth_getBlockReceipts", "eth_getBlockTransactionCountByHash", "eth_getBlockTransactionCountByNumber", "eth_getCode", "eth_getProof", "eth_getStorageAt", "eth_getTransactionByBlockHashAndIndex", "eth_getTransactionByBlockNumberAndIndex", "eth_getTransactionByHash", "eth_getTransactionCount", "eth_getTransactionReceipt", "eth_maxPriorityFeePerGas", "eth_sendRawTransaction", "net_version", "web3_clientVersion"];
+/** Read-only Solana methods plus `sendTransaction`. Anything not listed is rejected. */
+export declare const SOLANA_RPC_METHODS: readonly ["getAccountInfo", "getBalance", "getBlock", "getBlockHeight", "getBlockTime", "getEpochInfo", "getFeeForMessage", "getGenesisHash", "getLatestBlockhash", "getMinimumBalanceForRentExemption", "getMultipleAccounts", "getRecentPrioritizationFees", "getSignatureStatuses", "getSignaturesForAddress", "getSlot", "getTokenAccountBalance", "getTokenAccountsByOwner", "getTokenSupply", "getTransaction", "getVersion", "isBlockhashValid", "sendTransaction", "simulateTransaction"];
+export type EvmRpcMethod = (typeof EVM_RPC_METHODS)[number];
+export type SolanaRpcMethod = (typeof SOLANA_RPC_METHODS)[number];
+export declare const jsonRpcId: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+/** Method-agnostic wire shape of a call or batch (the gateway narrows by family). */
+export declare const rpcRequest: z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  method: z.ZodMiniString<string>;
+  params: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniUnknown>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>>;
+}, z.core.$strip>, z.ZodMiniArray<z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  method: z.ZodMiniString<string>;
+  params: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniUnknown>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>>;
+}, z.core.$strip>>]>;
+export declare const evmRpcRequest: z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  method: z.ZodMiniEnum<{
+    eth_blobBaseFee: "eth_blobBaseFee";
+    eth_blockNumber: "eth_blockNumber";
+    eth_call: "eth_call";
+    eth_chainId: "eth_chainId";
+    eth_createAccessList: "eth_createAccessList";
+    eth_estimateGas: "eth_estimateGas";
+    eth_feeHistory: "eth_feeHistory";
+    eth_gasPrice: "eth_gasPrice";
+    eth_getBalance: "eth_getBalance";
+    eth_getBlockByHash: "eth_getBlockByHash";
+    eth_getBlockByNumber: "eth_getBlockByNumber";
+    eth_getBlockReceipts: "eth_getBlockReceipts";
+    eth_getBlockTransactionCountByHash: "eth_getBlockTransactionCountByHash";
+    eth_getBlockTransactionCountByNumber: "eth_getBlockTransactionCountByNumber";
+    eth_getCode: "eth_getCode";
+    eth_getProof: "eth_getProof";
+    eth_getStorageAt: "eth_getStorageAt";
+    eth_getTransactionByBlockHashAndIndex: "eth_getTransactionByBlockHashAndIndex";
+    eth_getTransactionByBlockNumberAndIndex: "eth_getTransactionByBlockNumberAndIndex";
+    eth_getTransactionByHash: "eth_getTransactionByHash";
+    eth_getTransactionCount: "eth_getTransactionCount";
+    eth_getTransactionReceipt: "eth_getTransactionReceipt";
+    eth_maxPriorityFeePerGas: "eth_maxPriorityFeePerGas";
+    eth_sendRawTransaction: "eth_sendRawTransaction";
+    net_version: "net_version";
+    web3_clientVersion: "web3_clientVersion";
+  }>;
+  params: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniUnknown>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>>;
+}, z.core.$strip>, z.ZodMiniArray<z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  method: z.ZodMiniEnum<{
+    eth_blobBaseFee: "eth_blobBaseFee";
+    eth_blockNumber: "eth_blockNumber";
+    eth_call: "eth_call";
+    eth_chainId: "eth_chainId";
+    eth_createAccessList: "eth_createAccessList";
+    eth_estimateGas: "eth_estimateGas";
+    eth_feeHistory: "eth_feeHistory";
+    eth_gasPrice: "eth_gasPrice";
+    eth_getBalance: "eth_getBalance";
+    eth_getBlockByHash: "eth_getBlockByHash";
+    eth_getBlockByNumber: "eth_getBlockByNumber";
+    eth_getBlockReceipts: "eth_getBlockReceipts";
+    eth_getBlockTransactionCountByHash: "eth_getBlockTransactionCountByHash";
+    eth_getBlockTransactionCountByNumber: "eth_getBlockTransactionCountByNumber";
+    eth_getCode: "eth_getCode";
+    eth_getProof: "eth_getProof";
+    eth_getStorageAt: "eth_getStorageAt";
+    eth_getTransactionByBlockHashAndIndex: "eth_getTransactionByBlockHashAndIndex";
+    eth_getTransactionByBlockNumberAndIndex: "eth_getTransactionByBlockNumberAndIndex";
+    eth_getTransactionByHash: "eth_getTransactionByHash";
+    eth_getTransactionCount: "eth_getTransactionCount";
+    eth_getTransactionReceipt: "eth_getTransactionReceipt";
+    eth_maxPriorityFeePerGas: "eth_maxPriorityFeePerGas";
+    eth_sendRawTransaction: "eth_sendRawTransaction";
+    net_version: "net_version";
+    web3_clientVersion: "web3_clientVersion";
+  }>;
+  params: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniUnknown>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>>;
+}, z.core.$strip>>]>;
+export declare const solanaRpcRequest: z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  method: z.ZodMiniEnum<{
+    getAccountInfo: "getAccountInfo";
+    getBalance: "getBalance";
+    getBlock: "getBlock";
+    getBlockHeight: "getBlockHeight";
+    getBlockTime: "getBlockTime";
+    getEpochInfo: "getEpochInfo";
+    getFeeForMessage: "getFeeForMessage";
+    getGenesisHash: "getGenesisHash";
+    getLatestBlockhash: "getLatestBlockhash";
+    getMinimumBalanceForRentExemption: "getMinimumBalanceForRentExemption";
+    getMultipleAccounts: "getMultipleAccounts";
+    getRecentPrioritizationFees: "getRecentPrioritizationFees";
+    getSignatureStatuses: "getSignatureStatuses";
+    getSignaturesForAddress: "getSignaturesForAddress";
+    getSlot: "getSlot";
+    getTokenAccountBalance: "getTokenAccountBalance";
+    getTokenAccountsByOwner: "getTokenAccountsByOwner";
+    getTokenSupply: "getTokenSupply";
+    getTransaction: "getTransaction";
+    getVersion: "getVersion";
+    isBlockhashValid: "isBlockhashValid";
+    sendTransaction: "sendTransaction";
+    simulateTransaction: "simulateTransaction";
+  }>;
+  params: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniUnknown>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>>;
+}, z.core.$strip>, z.ZodMiniArray<z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  method: z.ZodMiniEnum<{
+    getAccountInfo: "getAccountInfo";
+    getBalance: "getBalance";
+    getBlock: "getBlock";
+    getBlockHeight: "getBlockHeight";
+    getBlockTime: "getBlockTime";
+    getEpochInfo: "getEpochInfo";
+    getFeeForMessage: "getFeeForMessage";
+    getGenesisHash: "getGenesisHash";
+    getLatestBlockhash: "getLatestBlockhash";
+    getMinimumBalanceForRentExemption: "getMinimumBalanceForRentExemption";
+    getMultipleAccounts: "getMultipleAccounts";
+    getRecentPrioritizationFees: "getRecentPrioritizationFees";
+    getSignatureStatuses: "getSignatureStatuses";
+    getSignaturesForAddress: "getSignaturesForAddress";
+    getSlot: "getSlot";
+    getTokenAccountBalance: "getTokenAccountBalance";
+    getTokenAccountsByOwner: "getTokenAccountsByOwner";
+    getTokenSupply: "getTokenSupply";
+    getTransaction: "getTransaction";
+    getVersion: "getVersion";
+    isBlockhashValid: "isBlockhashValid";
+    sendTransaction: "sendTransaction";
+    simulateTransaction: "simulateTransaction";
+  }>;
+  params: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniUnknown>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>>;
+}, z.core.$strip>>]>;
+export declare const jsonRpcResponse: z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  result: z.ZodMiniUnknown;
+}, z.core.$strip>, z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  error: z.ZodMiniObject<{
+    code: z.ZodMiniInt;
+    message: z.ZodMiniString<string>;
+    data: z.ZodMiniOptional<z.ZodMiniUnknown>;
+  }, z.core.$strip>;
+}, z.core.$strip>]>;
+export declare const rpcResponse: z.ZodMiniUnion<readonly [z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  result: z.ZodMiniUnknown;
+}, z.core.$strip>, z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  error: z.ZodMiniObject<{
+    code: z.ZodMiniInt;
+    message: z.ZodMiniString<string>;
+    data: z.ZodMiniOptional<z.ZodMiniUnknown>;
+  }, z.core.$strip>;
+}, z.core.$strip>]>, z.ZodMiniArray<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  result: z.ZodMiniUnknown;
+}, z.core.$strip>, z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  error: z.ZodMiniObject<{
+    code: z.ZodMiniInt;
+    message: z.ZodMiniString<string>;
+    data: z.ZodMiniOptional<z.ZodMiniUnknown>;
+  }, z.core.$strip>;
+}, z.core.$strip>]>>]>;
+export declare const rpc: Endpoint<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  method: z.ZodMiniString<string>;
+  params: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniUnknown>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>>;
+}, z.core.$strip>, z.ZodMiniArray<z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  method: z.ZodMiniString<string>;
+  params: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniUnknown>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>>;
+}, z.core.$strip>>]>, z.ZodMiniUnion<readonly [z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  result: z.ZodMiniUnknown;
+}, z.core.$strip>, z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  error: z.ZodMiniObject<{
+    code: z.ZodMiniInt;
+    message: z.ZodMiniString<string>;
+    data: z.ZodMiniOptional<z.ZodMiniUnknown>;
+  }, z.core.$strip>;
+}, z.core.$strip>]>, z.ZodMiniArray<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  result: z.ZodMiniUnknown;
+}, z.core.$strip>, z.ZodMiniObject<{
+  jsonrpc: z.ZodMiniLiteral<"2.0">;
+  id: z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>, z.ZodMiniNull]>;
+  error: z.ZodMiniObject<{
+    code: z.ZodMiniInt;
+    message: z.ZodMiniString<string>;
+    data: z.ZodMiniOptional<z.ZodMiniUnknown>;
+  }, z.core.$strip>;
+}, z.core.$strip>]>>]>>;
+/** The JSON-RPC URL path for one network. */
+export declare const rpcPath: (caip2: string) => string;
+type EsploraRoute = {
+  readonly method: "GET" | "POST";
+  readonly pattern: RegExp;
+};
+/** The Esplora surface the engine uses; every other path is rejected. */
+export declare const ESPLORA_ROUTES: ReadonlyArray<EsploraRoute>;
+/** `path` is the Esplora path after `/v1/esplora/:caip2`, with a leading slash and no query. */
+export declare const esploraPathAllowed: (method: string, path: string) => boolean;
+export declare const esploraGet: Endpoint<z.ZodMiniUndefined, z.ZodMiniUnknown>;
+/** The Esplora base path for one network; allow-listed paths are appended to it. */
+export declare const esploraBasePath: (caip2: string) => string;
+export declare const esploraPost: Endpoint<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+export declare const servedNetworksRequest: z.ZodMiniUndefined;
+/** The networks the gateway actually serves, in its configured order. */
+export declare const servedNetworksResponse: z.ZodMiniObject<{
+  networks: z.ZodMiniArray<z.ZodMiniString<string>>;
+}, z.core.$strip>;
+export declare const servedNetworks: Endpoint<z.ZodMiniUndefined, z.ZodMiniObject<{
+  networks: z.ZodMiniArray<z.ZodMiniString<string>>;
+}, z.core.$strip>>;
+export declare const networksPath: string;
+export { BITCOIN_NETWORKS, NETWORKS, type NetworkInfo, SOLANA_NETWORKS, networkById };
+//# sourceMappingURL=gateway-contract.d.mts.map

package/dist/gateway-contract.mjs

@@ -0,0 +1 @@
+export { a as BITCOIN_NETWORKS, l as ESPLORA_ROUTES, C as EVM_RPC_METHODS, _ as GATEWAY_ERRORS, v as INSTALL_ID_HEADER, o as NETWORKS, y as PROVIDERS_HEADER, w as RPC_BATCH_MAX, s as SOLANA_NETWORKS, T as SOLANA_RPC_METHODS, P as accepts, b as caip2, F as endpoint, u as esploraBasePath, d as esploraGet, f as esploraPathAllowed, p as esploraPost, E as evmRpcRequest, x as gatewayError, m as health, h as healthRequest, g as healthResponse, S as installId, D as jsonRpcId, O as jsonRpcResponse, c as networkById, t as networksPath, I as parseWith, k as rpc, A as rpcPath, j as rpcRequest, M as rpcResponse, n as servedNetworks, r as servedNetworksRequest, i as servedNetworksResponse, N as solanaRpcRequest } from "./contract-CEsgLme3.mjs";