@eco-foundation/api-schemas 0.1.0

package/dist/fixtures/v1/quotes-create.response.public-swap.json

@@ -0,0 +1,158 @@
+{
+    "endpointId": "quotes.create",
+    "direction": "response",
+    "variant": "public-swap",
+    "method": "POST",
+    "path": "/v1/quotes",
+    "expectedStatus": 200,
+    "sideEffect": true,
+    "payload": {
+        "id": "quote:8f14e45f-ea3c-4c2d-9b6e-1a2b3c4d5e6f",
+        "swapType": "exact-in",
+        "visibility": "public",
+        "guarantee": "atomic-or-refund",
+        "source": {
+            "chainId": 8453,
+            "token": "0x1111111111111111111111111111111111111111",
+            "amount": "1043221",
+            "symbol": "USDC",
+            "decimals": 6
+        },
+        "destination": {
+            "chainId": 10,
+            "token": "0x2222222222222222222222222222222222222222",
+            "amount": "1043221",
+            "minAmountOut": "1038005",
+            "recipient": "0x3333333333333333333333333333333333333333",
+            "symbol": "USDC",
+            "decimals": 6
+        },
+        "slippage": 0.005,
+        "fees": [
+            {
+                "kind": "gas",
+                "amount": "1200",
+                "token": {
+                    "chainId": 8453,
+                    "address": "0x1111111111111111111111111111111111111111",
+                    "symbol": "USDC",
+                    "decimals": 6
+                },
+                "estimate": true
+            }
+        ],
+        "steps": [
+            {
+                "kind": "swap",
+                "tool": "uniswap-v3",
+                "aggregator": "ecoswap",
+                "from": {
+                    "chainId": 8453,
+                    "token": "0x1111111111111111111111111111111111111111",
+                    "amount": "1043221"
+                },
+                "to": {
+                    "chainId": 8453,
+                    "token": "0x2222222222222222222222222222222222222222",
+                    "amount": "1043000"
+                },
+                "fees": [
+                    {
+                        "kind": "protocol",
+                        "amount": "221",
+                        "token": {
+                            "chainId": 8453,
+                            "address": "0x1111111111111111111111111111111111111111",
+                            "symbol": null,
+                            "decimals": null
+                        },
+                        "estimate": false
+                    }
+                ],
+                "estimatedDurationSec": 3
+            },
+            {
+                "kind": "bridge",
+                "tool": "eco",
+                "from": {
+                    "chainId": 8453,
+                    "token": "0x1111111111111111111111111111111111111111",
+                    "amount": "1043221"
+                },
+                "to": {
+                    "chainId": 10,
+                    "token": "0x2222222222222222222222222222222222222222",
+                    "amount": "1038005"
+                },
+                "fees": [],
+                "estimatedDurationSec": 20
+            }
+        ],
+        "relatedIntents": [
+            {
+                "role": "local",
+                "intentHash": "0xabababababababababababababababababababababababababababababababab"
+            },
+            {
+                "role": "bucket-candidate",
+                "intentHash": "0xefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefef",
+                "routeHash": "0x1212121212121212121212121212121212121212121212121212121212121212",
+                "bucketIndex": 0
+            }
+        ],
+        "solver": {
+            "id": "0x3333333333333333333333333333333333333333",
+            "name": "eco"
+        },
+        "intentHash": "0xabababababababababababababababababababababababababababababababab",
+        "execution": {
+            "transaction": {
+                "kind": "evm",
+                "chainId": 8453,
+                "to": "0x1111111111111111111111111111111111111111",
+                "data": "0xdeadbeef",
+                "value": "0"
+            },
+            "intent": {
+                "route": {
+                    "salt": "0xabababababababababababababababababababababababababababababababab",
+                    "deadline": 1767226200,
+                    "source": 8453,
+                    "destination": 10,
+                    "portal": "0x2222222222222222222222222222222222222222",
+                    "nativeAmount": "0",
+                    "tokens": [
+                        {
+                            "token": "0x2222222222222222222222222222222222222222",
+                            "amount": "1038005"
+                        }
+                    ],
+                    "calls": [
+                        {
+                            "target": "0x2222222222222222222222222222222222222222",
+                            "data": "0xbeef",
+                            "value": "0"
+                        }
+                    ]
+                },
+                "reward": {
+                    "deadline": 1767229800,
+                    "creator": "0x3333333333333333333333333333333333333333",
+                    "prover": "0x1111111111111111111111111111111111111111",
+                    "nativeAmount": "0",
+                    "tokens": [
+                        {
+                            "token": "0x1111111111111111111111111111111111111111",
+                            "amount": "1043221"
+                        }
+                    ]
+                }
+            },
+            "encodedRoute": "0xdead",
+            "encodedReward": "0xbeef"
+        },
+        "expiresAt": 1767225600,
+        "signature": "0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd",
+        "quotes": null
+    }
+}

package/dist/fixtures/v1/routes-list.response.default.json

@@ -0,0 +1,26 @@
+{
+    "endpointId": "routes.list",
+    "direction": "response",
+    "variant": "default",
+    "method": "GET",
+    "path": "/v1/routes",
+    "expectedStatus": 200,
+    "sideEffect": false,
+    "stability": "draft",
+    "payload": {
+        "routes": [
+            {
+                "source": {
+                    "chainId": 8453,
+                    "token": "0x1111111111111111111111111111111111111111"
+                },
+                "destination": {
+                    "chainId": 10,
+                    "token": "0x1111111111111111111111111111111111111111"
+                },
+                "swapTypes": ["exact-in"]
+            }
+        ],
+        "nextCursor": null
+    }
+}

package/dist/fixtures/v1/tokens-list.response.default.json

@@ -0,0 +1,24 @@
+{
+    "endpointId": "tokens.list",
+    "direction": "response",
+    "variant": "default",
+    "method": "GET",
+    "path": "/v1/tokens",
+    "expectedStatus": 200,
+    "sideEffect": false,
+    "payload": {
+        "tokens": [
+            {
+                "chainId": 8453,
+                "address": "0x1111111111111111111111111111111111111111",
+                "symbol": "USDC",
+                "decimals": 6,
+                "supports": {
+                    "quote": ["permit3", "permit2", "erc-3009"],
+                    "depositAddress": ["erc-2612", "erc-3009"]
+                }
+            }
+        ],
+        "nextCursor": null
+    }
+}

package/dist/generated/build-digest.json

@@ -0,0 +1,7 @@
+{
+    "digest": "72dceef6f939c524c595a94c80bdf2b545478022511aa58009573c8cd69dc432",
+    "inputs": [
+        "errors/catalog.lock.json",
+        "openapi/v1.json"
+    ]
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { V1_SCHEMA_DIGEST, V1_SCHEMA_DIGEST_INPUTS } from './build-digest';
+export { generateOpenApiDocument, STABLE_TAG } from './openapi';
+export type { V1Fixture } from './testing';
+export { assertMatchesV1Schema, loadV1Fixtures } from './testing';
+export * as v1 from './v1';
+export type { LegacyCodeRef, V1Chain, V1ChainType, V1DepositAddress, V1DepositAddressCreateRequest, V1DepositAddressKind, V1DestinationCall, V1ErrorCode, V1ErrorDefinition, V1Execution, V1Fee, V1FeeKind, V1FeeToken, V1FundingTransaction, V1GaslessJob, V1GaslessJobStatus, V1GaslessSubState, V1GaslessSubStatus, V1Guarantee, V1IntentCall, V1IntentReward, V1IntentRoute, V1IntentTokenAmount, V1ProblemBody, V1QuoteCore, V1QuoteRequest, V1QuoteResponse, V1RankedQuoteEntry, V1RelatedIntent, V1RelatedIntentRole, V1SolverIdentity, V1StatusEntry, V1StatusType, V1Step, V1StepKind, V1StepLeg, V1SwapType, V1TokenEntry, V1Visibility, } from './v1/types';

package/dist/index.js

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.v1 = exports.loadV1Fixtures = exports.assertMatchesV1Schema = exports.STABLE_TAG = exports.generateOpenApiDocument = exports.V1_SCHEMA_DIGEST_INPUTS = exports.V1_SCHEMA_DIGEST = void 0;
+var build_digest_1 = require("./build-digest");
+Object.defineProperty(exports, "V1_SCHEMA_DIGEST", { enumerable: true, get: function () { return build_digest_1.V1_SCHEMA_DIGEST; } });
+Object.defineProperty(exports, "V1_SCHEMA_DIGEST_INPUTS", { enumerable: true, get: function () { return build_digest_1.V1_SCHEMA_DIGEST_INPUTS; } });
+var openapi_1 = require("./openapi");
+Object.defineProperty(exports, "generateOpenApiDocument", { enumerable: true, get: function () { return openapi_1.generateOpenApiDocument; } });
+Object.defineProperty(exports, "STABLE_TAG", { enumerable: true, get: function () { return openapi_1.STABLE_TAG; } });
+var testing_1 = require("./testing");
+Object.defineProperty(exports, "assertMatchesV1Schema", { enumerable: true, get: function () { return testing_1.assertMatchesV1Schema; } });
+Object.defineProperty(exports, "loadV1Fixtures", { enumerable: true, get: function () { return testing_1.loadV1Fixtures; } });
+exports.v1 = __importStar(require("./v1"));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAA2E;AAAlE,gHAAA,gBAAgB,OAAA;AAAE,uHAAA,uBAAuB,OAAA;AAClD,qCAAgE;AAAvD,kHAAA,uBAAuB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAE5C,qCAAkE;AAAzD,gHAAA,qBAAqB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAC9C,2CAA2B"}

package/dist/openapi.d.ts

@@ -0,0 +1,2 @@
+export declare const STABLE_TAG = "stable";
+export declare function generateOpenApiDocument(): Record<string, unknown>;

package/dist/openapi.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STABLE_TAG = void 0;
+exports.generateOpenApiDocument = generateOpenApiDocument;
+const zod_1 = require("zod");
+const registry_1 = require("./v1/endpoints/registry");
+const catalog_1 = require("./v1/errors/catalog");
+const problem_1 = require("./v1/errors/problem");
+const PROBLEM_REF = '#/components/schemas/Problem';
+exports.STABLE_TAG = 'stable';
+function toSchema(schema, io) {
+    const json = zod_1.z.toJSONSchema(schema, { target: 'draft-2020-12', io });
+    delete json.$schema;
+    return json;
+}
+function parameters(def) {
+    const params = [];
+    for (const [name, schema] of Object.entries(def.pathParams ?? {})) {
+        params.push({ name, in: 'path', required: true, schema: toSchema(schema, 'input') });
+    }
+    for (const [name, schema] of Object.entries(def.query ?? {})) {
+        const optional = schema.safeParse(undefined).success;
+        params.push({ name, in: 'query', required: !optional, schema: toSchema(schema, 'input') });
+    }
+    return params;
+}
+function generateOpenApiDocument() {
+    const paths = {};
+    for (const [id, def] of Object.entries(registry_1.V1_ENDPOINTS)) {
+        const params = parameters(def);
+        const operation = {
+            operationId: id,
+            summary: def.summary,
+            tags: def.stability === 'draft' ? [def.tag] : [def.tag, exports.STABLE_TAG],
+            ...(def.stability === 'draft' ? { 'x-stability': 'draft' } : {}),
+            ...(params.length > 0 ? { parameters: params } : {}),
+            ...(def.request
+                ? {
+                    requestBody: {
+                        required: true,
+                        content: { 'application/json': { schema: toSchema(def.request, 'input') } },
+                    },
+                }
+                : {}),
+            responses: {
+                [String(def.successStatus)]: {
+                    description: 'Success',
+                    content: { 'application/json': { schema: toSchema(def.response, 'output') } },
+                },
+                default: {
+                    description: 'Error (RFC 9457 problem+json; see x-error-catalog)',
+                    content: { [problem_1.PROBLEM_CONTENT_TYPE]: { schema: { $ref: PROBLEM_REF } } },
+                },
+            },
+        };
+        (paths[def.path] ??= {})[def.method.toLowerCase()] = operation;
+    }
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: 'Eco API',
+            version: 'v1',
+            description: 'Generated from @eco-foundation/api-schemas — the Zod schemas are the source of truth.',
+        },
+        tags: [
+            { name: 'quotes' },
+            { name: 'intents' },
+            { name: 'status' },
+            { name: 'discovery' },
+            { name: 'deposit-addresses' },
+            {
+                name: exports.STABLE_TAG,
+                description: 'Operations committed for launch. Draft operations (x-stability: draft) are omitted.',
+            },
+        ],
+        paths,
+        components: { schemas: { Problem: toSchema(problem_1.V1ProblemSchema, 'output') } },
+        'x-error-catalog': catalog_1.V1_ERROR_CATALOG,
+    };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

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

package/dist/scripts/generate-build-digest.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/generate-build-digest.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const pkgRoot = (0, node_path_1.join)(__dirname, '..', '..');
+const INPUTS = ['errors/catalog.lock.json', 'openapi/v1.json'];
+const hash = (0, node_crypto_1.createHash)('sha256');
+for (const rel of INPUTS)
+    hash.update((0, node_fs_1.readFileSync)((0, node_path_1.join)(pkgRoot, rel)));
+const rendered = `${JSON.stringify({ digest: hash.digest('hex'), inputs: INPUTS }, null, 2)}\n`;
+const outPath = (0, node_path_1.join)(pkgRoot, 'src', 'generated', 'build-digest.json');
+if (process.argv.includes('--check')) {
+    const current = (0, node_fs_1.existsSync)(outPath) ? (0, node_fs_1.readFileSync)(outPath, 'utf8') : '';
+    if (current !== rendered) {
+        console.error('src/generated/build-digest.json is stale — run: pnpm run digest:generate');
+        process.exit(1);
+    }
+    console.log('build digest is current');
+}
+else {
+    (0, node_fs_1.writeFileSync)(outPath, rendered);
+    console.log(`wrote ${outPath}`);
+}
+//# sourceMappingURL=generate-build-digest.js.map

package/dist/scripts/generate-build-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-build-digest.js","sourceRoot":"","sources":["../../src/scripts/generate-build-digest.ts"],"names":[],"mappings":";;AAAA,6CAAyC;AACzC,qCAAkE;AAClE,yCAAiC;AAGjC,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAE5C,MAAM,MAAM,GAAG,CAAC,0BAA0B,EAAE,iBAAiB,CAAU,CAAC;AAExE,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC;AAClC,KAAK,MAAM,GAAG,IAAI,MAAM;IAAE,IAAI,CAAC,MAAM,CAAC,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACxE,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAGhG,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;AACvE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAA,oBAAU,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAA,sBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACzC,CAAC;KAAM,CAAC;IACN,IAAA,uBAAa,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/scripts/generate-openapi.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/generate-openapi.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const openapi_1 = require("../openapi");
+const outPath = (0, node_path_1.join)(__dirname, '..', '..', 'openapi', 'v1.json');
+const rendered = `${JSON.stringify((0, openapi_1.generateOpenApiDocument)(), null, 2)}\n`;
+if (process.argv.includes('--check')) {
+    const current = (0, node_fs_1.existsSync)(outPath) ? (0, node_fs_1.readFileSync)(outPath, 'utf8') : '';
+    if (current !== rendered) {
+        console.error('openapi/v1.json is stale — run: pnpm run openapi:generate');
+        process.exit(1);
+    }
+    console.log('openapi/v1.json is current');
+}
+else {
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(outPath), { recursive: true });
+    (0, node_fs_1.writeFileSync)(outPath, rendered);
+    console.log(`wrote ${outPath}`);
+}
+//# sourceMappingURL=generate-openapi.js.map

package/dist/scripts/generate-openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-openapi.js","sourceRoot":"","sources":["../../src/scripts/generate-openapi.ts"],"names":[],"mappings":";;AAAA,qCAA6E;AAC7E,yCAA0C;AAE1C,wCAAqD;AAGrD,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAClE,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,iCAAuB,GAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAE3E,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAA,oBAAU,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAA,sBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAC5C,CAAC;KAAM,CAAC;IACN,IAAA,mBAAS,EAAC,IAAA,mBAAO,EAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,IAAA,uBAAa,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,7 @@
+import { V1Fixture } from '../fixtures';
+import { V1EndpointId } from '../v1/endpoints/registry';
+export type { V1Fixture };
+export declare function assertMatchesV1Schema(endpointId: V1EndpointId, payload: unknown, opts?: {
+    direction?: 'request' | 'response';
+}): void;
+export declare function loadV1Fixtures(): readonly V1Fixture[];

package/dist/testing/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertMatchesV1Schema = assertMatchesV1Schema;
+exports.loadV1Fixtures = loadV1Fixtures;
+const zod_1 = require("zod");
+const fixtures_1 = require("../fixtures");
+const registry_1 = require("../v1/endpoints/registry");
+const DEFINITIONS = registry_1.V1_ENDPOINTS;
+function assertMatchesV1Schema(endpointId, payload, opts = {}) {
+    const direction = opts.direction ?? 'response';
+    const def = DEFINITIONS[endpointId];
+    if (!def) {
+        throw new Error(`unknown v1 endpoint id: "${String(endpointId)}" (direction: ${direction}); ` +
+            `known ids: ${Object.keys(registry_1.V1_ENDPOINTS).join(', ')}`);
+    }
+    const schema = direction === 'request' ? def.request : def.response;
+    if (!schema)
+        throw new Error(`${endpointId} has no ${direction} schema`);
+    const result = schema.safeParse(payload);
+    if (!result.success) {
+        throw new Error(`payload does not match ${endpointId} ${direction} schema:\n${zod_1.z.prettifyError(result.error)}`);
+    }
+}
+function loadV1Fixtures() {
+    return fixtures_1.V1_FIXTURES;
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";;AA0BA,sDAqBC;AAED,wCAEC;AAnDD,6BAAwB;AAExB,0CAAqD;AACrD,uDAA4F;AAY5F,MAAM,WAAW,GAA+C,uBAAY,CAAC;AAW7E,SAAgB,qBAAqB,CACnC,UAAwB,EACxB,OAAgB,EAChB,OAA+C,EAAE;IAEjD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC;IAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,CAAC,UAAU,CAAC,iBAAiB,SAAS,KAAK;YAC3E,cAAc,MAAM,CAAC,IAAI,CAAC,uBAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAA0B,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC3F,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,WAAW,SAAS,SAAS,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,0BAA0B,UAAU,IAAI,SAAS,aAAa,OAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAgB,cAAc;IAC5B,OAAO,sBAAW,CAAC;AACrB,CAAC"}

package/dist/v1/endpoints/chains.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export declare const ChainContractsSchema: z.ZodObject<{
+    portal: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>]>;
+    executor: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>]>>;
+}, z.core.$loose>;
+export declare const ChainSchema: z.ZodObject<{
+    chainId: z.ZodNumber;
+    name: z.ZodString;
+    quoteSigner: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>]>;
+    type: z.ZodEnum<{
+        evm: "evm";
+        svm: "svm";
+        tvm: "tvm";
+    }>;
+    encoding: z.ZodEnum<{
+        abi: "abi";
+        borsh: "borsh";
+    }>;
+    status: z.ZodEnum<{
+        live: "live";
+        paused: "paused";
+    }>;
+    contracts: z.ZodObject<{
+        portal: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>]>;
+        executor: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>]>>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export type Chain = z.input<typeof ChainSchema>;
+export declare const ChainsResponseSchema: z.ZodObject<{
+    chains: z.ZodArray<z.ZodObject<{
+        chainId: z.ZodNumber;
+        name: z.ZodString;
+        quoteSigner: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>]>;
+        type: z.ZodEnum<{
+            evm: "evm";
+            svm: "svm";
+            tvm: "tvm";
+        }>;
+        encoding: z.ZodEnum<{
+            abi: "abi";
+            borsh: "borsh";
+        }>;
+        status: z.ZodEnum<{
+            live: "live";
+            paused: "paused";
+        }>;
+        contracts: z.ZodObject<{
+            portal: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>]>;
+            executor: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodString]>]>>;
+        }, z.core.$loose>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;

package/dist/v1/endpoints/chains.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainsResponseSchema = exports.ChainSchema = exports.ChainContractsSchema = void 0;
+const zod_1 = require("zod");
+const enums_1 = require("../enums");
+const primitives_1 = require("../primitives");
+exports.ChainContractsSchema = zod_1.z.looseObject({
+    portal: primitives_1.AnyAddress,
+    executor: primitives_1.AnyAddress.nullable(),
+});
+exports.ChainSchema = zod_1.z.looseObject({
+    chainId: primitives_1.ChainId,
+    name: zod_1.z.string().min(1),
+    quoteSigner: primitives_1.AnyAddress,
+    type: enums_1.ChainType,
+    encoding: enums_1.ChainEncoding,
+    status: enums_1.ChainStatus,
+    contracts: exports.ChainContractsSchema,
+});
+exports.ChainsResponseSchema = zod_1.z.looseObject({
+    chains: zod_1.z.array(exports.ChainSchema),
+});
+//# sourceMappingURL=chains.js.map

package/dist/v1/endpoints/chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../src/v1/endpoints/chains.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,oCAAiE;AACjE,8CAAoD;AAKvC,QAAA,oBAAoB,GAAG,OAAC,CAAC,WAAW,CAAC;IAChD,MAAM,EAAE,uBAAU;IAMlB,QAAQ,EAAE,uBAAU,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEU,QAAA,WAAW,GAAG,OAAC,CAAC,WAAW,CAAC;IACvC,OAAO,EAAE,oBAAO;IAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IASvB,WAAW,EAAE,uBAAU;IAEvB,IAAI,EAAE,iBAAS;IACf,QAAQ,EAAE,qBAAa;IAEvB,MAAM,EAAE,mBAAW;IACnB,SAAS,EAAE,4BAAoB;CAChC,CAAC,CAAC;AAGU,QAAA,oBAAoB,GAAG,OAAC,CAAC,WAAW,CAAC;IAChD,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,mBAAW,CAAC;CAC7B,CAAC,CAAC"}