stellarium-ts 0.19.0 → 0.20.0

package/dist/server.d.ts

@@ -8,6 +8,8 @@ import { RateLimitConfig } from './routes.js';
 import { type NodeConfig } from './service.js';
 export declare const DEFAULT_COST_LIMIT_MICRO_USD = 10000;
 export declare const DEFAULT_GRANT_REFRESH_INTERVAL_MS: number;
+/** How often a node with an operator asks it again for its organization and price, which may change on the dashboard. */
+export declare const DEFAULT_SESSION_REFRESH_INTERVAL_MS: number;
 export interface StellariumNodeOptions {
     port?: number;
     host?: string;
@@ -36,8 +38,33 @@ export interface StellariumNodeOptions {
      * Defaults to `INFERENCE_COST_LIMIT_MICRO_USD`, then to the resolved `costLimitMicroUsd`.
      */
     inferenceCostLimitMicroUsd?: number;
-    /** SQLite file. Defaults to `./requestscript.db`; use ':memory:' for tests. */
+    /**
+     * Most one call to a contract on another node may cost: what its voucher lets the provider hold for the
+     * contract's tokens and its paid calls. Defaults to `CONTRACT_COST_LIMIT_MICRO_USD`, then to the resolved
+     * `costLimitMicroUsd`.
+     */
+    contractCostLimitMicroUsd?: number;
+    /** What another organization pays to deploy a contract to this node. Defaults to `CONTRACT_DEPLOY_FEE_MICRO_USD`, then 0. */
+    contractDeployFeeMicroUsd?: number;
+    /** Largest contract source this node accepts, in bytes. Defaults to `MAX_CONTRACT_SOURCE_BYTES`, then 64 KiB. */
+    maxContractSourceBytes?: number;
+    /**
+     * Most one contract's state may hold in one scope, in bytes of its variables' encoded values. A call that
+     * would grow it past this fails and saves nothing. Defaults to `MAX_CONTRACT_STATE_BYTES`, then 64 KiB.
+     */
+    maxContractStateBytes?: number;
+    /** SQLite file. Defaults to `DATABASE_PATH`, then `./requestscript.db`; use ':memory:' for tests. */
     databasePath?: string;
+    /**
+     * A `postgres://` or `postgresql://` URL. Defaults to `DATABASE_URL`. When set, the node keeps its data in
+     * Postgres instead of a SQLite file, so `databasePath` must not be set too.
+     */
+    databaseUrl?: string;
+    /**
+     * Postgres schema for the node's tables, created if missing, so several nodes can share a database.
+     * Defaults to `DATABASE_SCHEMA`, then to the connection's search path.
+     */
+    databaseSchema?: string;
     /**
      * Grant chains addressed to this node, stored at start. Each is root first. A stored renewal
      * of the same grant is kept, and an expired chain is skipped with a warning.
@@ -45,6 +72,8 @@ export interface StellariumNodeOptions {
     grants?: Grant[][];
     /** How often held grants past half their lifetime are renewed. Defaults to 5 minutes. */
     grantRefreshIntervalMs?: number;
+    /** How often to ask the operator again for this node's organization and price. Defaults to five minutes. */
+    sessionRefreshIntervalMs?: number;
     /**
      * Decides callers' requests for grants on this node's resources (`POST /v1/grants/request`).
      * Without it, callers can only get grants from `issueGrant`.

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAiB,KAAK,UAAU,EAAgB,MAAM,cAAc,CAAC;AAI5E,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,iCAAiC,QAAgB,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wGAAwG;IACxG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;IACnB,yFAAyF;IACzF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAaD,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,EAAE,SAAS,GAAE,kBAAkB,EAAO,GAAG,UAAU,CAwB9G;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAU;IAEpB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;IAED;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0EnF;IAED,8FAA8F;IACxF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAEtG;IAED;;;OAGG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAEvI;IAED,wFAAwF;IAClF,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAE3H;IAED,mDAAmD;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5C;IAED;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;IAED,4FAA4F;IACtF,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;IAED,yCAAyC;IACnC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvD;IAED,OAAO,CAAC,OAAO;CAMlB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -1,12 +1,17 @@
 import 'dotenv/config';
-import { DEFAULT_DATABASE_PATH, openDatabase } from './db/db.js';
+import { DEFAULT_DATABASE_PATH, isPostgresUrl, openDatabase } from './db/db.js';
+import { assertSchemaName } from './db/postgres.js';
+import { DEFAULT_MAX_CONTRACT_SOURCE_BYTES } from './contract/service.js';
+import { DEFAULT_MAX_CONTRACT_STATE_BYTES } from './contract/state.js';
 import { validateInferenceFunction } from './resource/inference.js';
 import routes from './routes.js';
 import { createService } from './service.js';
-import { StartupService } from './startup.js';
+import { announceResources, StartupService } from './startup.js';
 import { OperatorClient } from './client/operatorClient.js';
 export const DEFAULT_COST_LIMIT_MICRO_USD = 10_000;
 export const DEFAULT_GRANT_REFRESH_INTERVAL_MS = 1000 * 60 * 5;
+/** How often a node with an operator asks it again for its organization and price, which may change on the dashboard. */
+export const DEFAULT_SESSION_REFRESH_INTERVAL_MS = 1000 * 60 * 5;
 function required(name, value) {
     if (!value) {
         throw new Error(`${name} is required: pass it to StellariumNode.start or set it in the environment`);
@@ -28,6 +33,10 @@ export function resolveConfig(options, resources = []) {
     for (const resource of resources) {
         resource.functions.forEach(validateInferenceFunction);
     }
+    const contractCostLimit = nonnegativeInteger('contractCostLimitMicroUsd', options.contractCostLimitMicroUsd, process.env.CONTRACT_COST_LIMIT_MICRO_USD) ?? costLimit;
+    const contractDeployFee = nonnegativeInteger('contractDeployFeeMicroUsd', options.contractDeployFeeMicroUsd, process.env.CONTRACT_DEPLOY_FEE_MICRO_USD) ?? 0;
+    const maxContractSourceBytes = nonnegativeInteger('maxContractSourceBytes', options.maxContractSourceBytes, process.env.MAX_CONTRACT_SOURCE_BYTES) ?? DEFAULT_MAX_CONTRACT_SOURCE_BYTES;
+    const maxContractStateBytes = nonnegativeInteger('maxContractStateBytes', options.maxContractStateBytes, process.env.MAX_CONTRACT_STATE_BYTES) ?? DEFAULT_MAX_CONTRACT_STATE_BYTES;
     return {
         baseUrl: required('BASE_URL', options.baseUrl ?? process.env.BASE_URL),
         publicKey: required('SIGNING_PUBLIC_KEY', options.publicKey ?? process.env.SIGNING_PUBLIC_KEY),
@@ -39,8 +48,43 @@ export function resolveConfig(options, resources = []) {
             : options.operatorUrl ?? process.env.OPERATOR_URL,
         costLimitMicroUsd: costLimit,
         inferenceCostLimitMicroUsd: inferenceCostLimit,
+        contractCostLimitMicroUsd: contractCostLimit,
+        contractDeployFeeMicroUsd: contractDeployFee,
+        maxContractSourceBytes,
+        maxContractStateBytes,
+        ...resolveDatabase(options),
     };
 }
+/** An option, else its environment variable, which must be a nonnegative integer. Undefined when neither is set. */
+function nonnegativeInteger(name, option, env) {
+    const value = option ?? (env ? Number(env) : undefined);
+    if (value !== undefined && (!Number.isSafeInteger(value) || value < 0)) {
+        throw new Error(`${name} must be a nonnegative integer`);
+    }
+    return value;
+}
+function resolveDatabase(options) {
+    // Empty variables, as a compose file or .env may leave them, count as unset.
+    const databaseUrl = options.databaseUrl ?? (process.env.DATABASE_URL || undefined);
+    const databasePath = options.databasePath ?? (process.env.DATABASE_PATH || undefined);
+    const databaseSchema = options.databaseSchema ?? (process.env.DATABASE_SCHEMA || undefined);
+    if (databaseSchema !== undefined) {
+        if (databaseUrl === undefined) {
+            throw new Error('databaseSchema (DATABASE_SCHEMA) needs a Postgres databaseUrl (DATABASE_URL)');
+        }
+        assertSchemaName(databaseSchema);
+    }
+    if (databaseUrl === undefined) {
+        return { databasePath: databasePath ?? DEFAULT_DATABASE_PATH };
+    }
+    if (!isPostgresUrl(databaseUrl)) {
+        throw new Error('databaseUrl (DATABASE_URL) must be a postgres:// or postgresql:// URL');
+    }
+    if (databasePath !== undefined) {
+        throw new Error('Set either databaseUrl (DATABASE_URL) for Postgres or databasePath (DATABASE_PATH) for SQLite, not both');
+    }
+    return { databaseUrl, databaseSchema };
+}
 export class StellariumNode {
     resources = [];
     service;
@@ -61,7 +105,7 @@ export class StellariumNode {
         const session = () => new OperatorClient(config.operatorUrl, config.publicKey, config.privateKey).session(enrollmentToken, config.baseUrl);
         if (hostsPaidFunctions(this.resources) || enrollmentToken) {
             try {
-                ({ organizationId: config.organizationId } = await session());
+                ({ organizationId: config.organizationId, priceMicroUsdPerMillionTokens: config.priceMicroUsdPerMillionTokens } = await session());
             }
             catch (error) {
                 const hint = enrollmentToken ? '' : '. Create an enrollment token for it at https://platform.stellarium.sh and set ENROLLMENT_TOKEN';
@@ -71,13 +115,14 @@ export class StellariumNode {
         else if (config.operatorUrl) {
             // Serving doesn't depend on it, so it doesn't hold up the start. Until it answers, run tokens from
             // this node's own organization are refused as if billed.
-            session().then(({ organizationId }) => {
+            session().then(({ organizationId, priceMicroUsdPerMillionTokens }) => {
                 config.organizationId = organizationId;
+                config.priceMicroUsdPerMillionTokens = priceMicroUsdPerMillionTokens;
             }, (error) => {
                 fastify.log.warn(`No session with the operator, so this node can't be listed: ${error instanceof Error ? error.message : String(error)}`);
             });
         }
-        const db = await openDatabase(options.databasePath ?? DEFAULT_DATABASE_PATH);
+        const db = await openDatabase(config.databaseUrl ?? config.databasePath, { schema: config.databaseSchema });
         fastify.addHook('onClose', async () => db.close());
         const service = createService(db, this.resources, config, { approveGrant: options.approveGrant });
         // A configured chain may be older than its stored renewal, or long expired; neither should stop the node.
@@ -112,11 +157,41 @@ export class StellariumNode {
             refresher.unref();
         };
         scheduleRefresh();
+        // Contracts are advertised at the node's price, which its organization may change at any time.
+        let sessionRefresher;
+        const scheduleSessionRefresh = () => {
+            sessionRefresher = setTimeout(async () => {
+                try {
+                    const { organizationId, priceMicroUsdPerMillionTokens } = await session();
+                    const changed = organizationId !== config.organizationId || priceMicroUsdPerMillionTokens !== config.priceMicroUsdPerMillionTokens;
+                    config.organizationId = organizationId;
+                    config.priceMicroUsdPerMillionTokens = priceMicroUsdPerMillionTokens;
+                    if (changed && (await service.contractRepository.allLatest()).length > 0) {
+                        service.contractService.announce?.();
+                    }
+                }
+                catch (error) {
+                    fastify.log.warn(`Failed to refresh this node's session with the operator: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                if (!closed) {
+                    scheduleSessionRefresh();
+                }
+            }, options.sessionRefreshIntervalMs ?? DEFAULT_SESSION_REFRESH_INTERVAL_MS);
+            sessionRefresher.unref();
+        };
+        if (config.operatorUrl) {
+            scheduleSessionRefresh();
+        }
         fastify.addHook('onClose', async () => {
             closed = true;
             clearTimeout(refresher);
+            clearTimeout(sessionRefresher);
         });
         await fastify.register(routes, { prefix: '/v1', service, rateLimit: options.rateLimit });
+        // Peers learn of a contract as soon as it is deployed, and forget it when it is deleted.
+        service.contractService.announce = () => {
+            announceResources(fastify.log, service).catch(error => fastify.log.error(error, 'Failed to announce resources'));
+        };
         const address = await fastify.listen({ port: options.port ?? 3000, host: options.host ?? '0.0.0.0' });
         fastify.log.info(`server listening on ${address}`);
         if (options.startingPeer) {

package/dist/service.d.ts

@@ -1,12 +1,15 @@
 import type { JWTVerifyGetKey } from "jose";
 import { ResourceResolver } from "requestscript";
-import type { Database } from "sqlite";
+import type { NodeDatabase } from "./db/database.js";
 import { PeerRepository } from "./peer/repository.js";
 import { ResourceRepository, type StellariumResource } from "./resource/repository.js";
 import { CombinationResourceInvoker } from "./resource/invoker.js";
 import { OperatorClient } from "./client/operatorClient.js";
 import { RunTokenVerifier } from "./client/runTokens.js";
 import { type ApproveGrant, GrantService } from "./grant/service.js";
+import { ContractRepository } from "./contract/repository.js";
+import { ContractService } from "./contract/service.js";
+import { ContractStateRepository } from "./contract/state.js";
 /** Settings a node runs with. `StellariumNode.start` fills these from its options, then the environment. */
 export interface NodeConfig {
     /** URL peers use to reach this node. Also its peer name. */
@@ -28,6 +31,25 @@ export interface NodeConfig {
     costLimitMicroUsd: number;
     /** Most this node will sign for in one remote inference call. */
     inferenceCostLimitMicroUsd: number;
+    /** Most one call to a contract on another node may hold: its voucher's `maxAmount`. Defaults to `costLimitMicroUsd`. */
+    contractCostLimitMicroUsd?: number;
+    /** What another organization pays to deploy a contract to this node. 0 or unset is free. */
+    contractDeployFeeMicroUsd?: number;
+    /** Largest contract source this node accepts. Defaults to 64 KiB. */
+    maxContractSourceBytes?: number;
+    /** Most one contract's state may hold in one scope, its variables' encoded values together. Defaults to 64 KiB. */
+    maxContractStateBytes?: number;
+    /**
+     * This node's listed price per million script tokens, which its contracts are charged at. `StellariumNode.start`
+     * learns it from the operator.
+     */
+    priceMicroUsdPerMillionTokens?: number;
+    /** SQLite file the node opens, when it has no `databaseUrl`. */
+    databasePath?: string;
+    /** Postgres URL. When set, the node uses Postgres instead of SQLite. */
+    databaseUrl?: string;
+    /** Postgres schema the node's tables live in. */
+    databaseSchema?: string;
 }
 export interface Service {
     config: NodeConfig;
@@ -37,6 +59,9 @@ export interface Service {
     resourceInvoker: CombinationResourceInvoker;
     operatorClient: OperatorClient;
     grantService: GrantService;
+    contractRepository: ContractRepository;
+    contractService: ContractService;
+    contractStateRepository: ContractStateRepository;
     /** Verifies the run tokens `POST /v1/run` accepts. Set when the node has an operator URL. */
     runTokenVerifier?: RunTokenVerifier;
 }
@@ -46,5 +71,5 @@ export interface ServiceOptions {
     /** Replaces the operator's published keys for verifying run tokens, in tests. */
     runTokenKeys?: JWTVerifyGetKey;
 }
-export declare function createService(db: Database, resources: StellariumResource[], config: NodeConfig, options?: ServiceOptions): Service;
+export declare function createService(db: NodeDatabase, resources: StellariumResource[], config: NodeConfig, options?: ServiceOptions): Service;
 //# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,KAAK,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,4GAA4G;AAC5G,MAAM,WAAW,UAAU;IACvB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,iJAAiJ;IACjJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iHAAiH;IACjH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,0BAA0B,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,0BAA0B,CAAC;IAC5C,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC3B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iFAAiF;IACjF,YAAY,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAwBtI"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,KAAK,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,4GAA4G;AAC5G,MAAM,WAAW,UAAU;IACvB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,iJAAiJ;IACjJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iHAAiH;IACjH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,0BAA0B,EAAE,MAAM,CAAC;IACnC,wHAAwH;IACxH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,4FAA4F;IAC5F,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mHAAmH;IACnH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,0BAA0B,CAAC;IAC5C,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC3B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iFAAiF;IACjF,YAAY,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAqC1I"}

package/dist/service.js

@@ -6,8 +6,17 @@ import { OperatorClient } from "./client/operatorClient.js";
 import { RunTokenVerifier } from "./client/runTokens.js";
 import { GrantRepository } from "./grant/repository.js";
 import { GrantService } from "./grant/service.js";
+import { ContractRepository } from "./contract/repository.js";
+import { ContractService } from "./contract/service.js";
+import { ContractStateRepository } from "./contract/state.js";
 export function createService(db, resources, config, options = {}) {
-    const resourceRepository = new ResourceRepository(db, resources, config.baseUrl, config.organizationId);
+    const contractRepository = new ContractRepository(db);
+    // Read from the config on each use, since the node may learn its organization and price after it starts.
+    const resourceRepository = new ResourceRepository(db, resources, config.baseUrl, config.organizationId, {
+        repository: contractRepository,
+        price: () => config.priceMicroUsdPerMillionTokens ?? 0,
+        organizationId: () => config.organizationId,
+    });
     const resourceResolver = new CombinationResourceResolver(resourceRepository);
     const grantService = new GrantService(new GrantRepository(db), config, options.approveGrant);
     const operatorClient = new OperatorClient(config.operatorUrl, config.publicKey, config.privateKey);
@@ -15,6 +24,9 @@ export function createService(db, resources, config, options = {}) {
         operatorClient,
         organizationId: config.organizationId,
     });
+    const contractStateRepository = new ContractStateRepository(db);
+    const contractService = new ContractService(contractRepository, contractStateRepository, resourceRepository, resourceResolver, resourceInvoker, operatorClient, config);
+    resourceInvoker.contracts = { costLimitMicroUsd: config.contractCostLimitMicroUsd ?? config.costLimitMicroUsd, host: contractService };
     return {
         config,
         peerRepository: new PeerRepository(db),
@@ -23,6 +35,9 @@ export function createService(db, resources, config, options = {}) {
         resourceInvoker,
         operatorClient,
         grantService,
+        contractRepository,
+        contractService,
+        contractStateRepository,
         runTokenVerifier: config.operatorUrl ? new RunTokenVerifier(config.operatorUrl, config.publicKey, options.runTokenKeys) : undefined,
     };
 }

package/dist/startup.d.ts

@@ -4,6 +4,8 @@ import { Service } from "./service.js";
 export declare const STARTUP_REQUEST_TIMEOUT_MS = 10000;
 /** Peers and resources requested per page from the starting peer. It may return fewer. */
 export declare const STARTUP_PAGE_SIZE = 100;
+/** Sends this node's resources, signed, to every peer it knows. Run at startup, and when a contract is deployed or deleted. */
+export declare function announceResources(log: FastifyBaseLogger, service: Service): Promise<void>;
 export declare class StartupService {
     private readonly log;
     private readonly service;
@@ -23,8 +25,6 @@ export declare class StartupService {
     private isSelf;
     populatePeers(): Promise<void>;
     populateResources(): Promise<void>;
-    /** PUT to every peer, logging failures instead of throwing so one bad peer doesn't stop the rest. */
-    private putToPeers;
     broadcastSelf(): Promise<void>;
 }
 //# sourceMappingURL=startup.d.ts.map

package/dist/startup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../src/startup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,4CAA4C;AAC5C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAKrC,qBAAa,cAAc;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN/B,YACqB,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EACnC;IAGE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAUlC;IAED,iFAAiF;YACnE,mBAAmB;IAQjC;;;OAGG;YACW,2BAA2B;IAsBzC,OAAO,CAAC,MAAM;IAIR,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBnC;IAEK,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWvC;IAED,qGAAqG;YACvF,UAAU;IAqBlB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BnC;CACJ"}
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../src/startup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,4CAA4C;AAC5C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAiCrC,+HAA+H;AAC/H,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/F;AAED,qBAAa,cAAc;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN/B,YACqB,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EACnC;IAGE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAUlC;IAED,iFAAiF;YACnE,mBAAmB;IAQjC;;;OAGG;YACW,2BAA2B;IAsBzC,OAAO,CAAC,MAAM;IAIR,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBnC;IAEK,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWvC;IAEK,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAenC;CACJ"}

package/dist/startup.js

@@ -7,6 +7,47 @@ export const STARTUP_REQUEST_TIMEOUT_MS = 10_000;
 export const STARTUP_PAGE_SIZE = 100;
 // 10 minutes
 const SIGNATURE_LIFETIME_MS = 1000 * 60 * 10;
+/** PUT to every peer, logging failures instead of throwing so one bad peer doesn't stop the rest. */
+async function putToPeers(log, peers, path, body, description) {
+    for (const peer of peers) {
+        try {
+            const response = await fetch(`${peer.baseUrl}/v1${path}`, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(STARTUP_REQUEST_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                log.warn(`Failed to broadcast ${description} to node ${peer.baseUrl}: ${response.status} ${await response.text()}`);
+            }
+        }
+        catch (error) {
+            log.warn(error, `Failed to broadcast ${description} to node ${peer.baseUrl}`);
+        }
+    }
+}
+/** The peers this node knows, other than itself. */
+async function otherPeers(service) {
+    const { baseUrl, publicKey } = service.config;
+    return (await service.peerRepository.getPeerList()).filter(peer => peer.publicKey !== publicKey && peer.baseUrl !== baseUrl);
+}
+/** Sends this node's resources, signed, to every peer it knows. Run at startup, and when a contract is deployed or deleted. */
+export async function announceResources(log, service) {
+    log.info(`Broadcasting resources to peers`);
+    const peers = await otherPeers(service);
+    const resources = await service.resourceRepository.getInternalResources();
+    const expiry = new Date(Date.now() + SIGNATURE_LIFETIME_MS).toISOString();
+    const signature = signData(resourceAnnouncementPayload(resources, expiry), service.config.privateKey);
+    await putToPeers(log, peers, '/all-resources', {
+        publicKey: service.config.publicKey,
+        resources,
+        expiry,
+        signature,
+    }, 'resources');
+    log.info(`Broadcasted ${resources.length} resources to ${peers.length} peers`);
+}
 export class StartupService {
     log;
     service;
@@ -91,27 +132,6 @@ export class StartupService {
         });
         this.log.info(`Learned up to ${count} resources`);
     }
-    /** PUT to every peer, logging failures instead of throwing so one bad peer doesn't stop the rest. */
-    async putToPeers(peers, path, body, description) {
-        for (const peer of peers) {
-            try {
-                const response = await fetch(`${peer.baseUrl}/v1${path}`, {
-                    method: 'PUT',
-                    headers: {
-                        'Content-Type': 'application/json',
-                    },
-                    body: JSON.stringify(body),
-                    signal: AbortSignal.timeout(STARTUP_REQUEST_TIMEOUT_MS),
-                });
-                if (!response.ok) {
-                    this.log.warn(`Failed to broadcast ${description} to node ${peer.baseUrl}: ${response.status} ${await response.text()}`);
-                }
-            }
-            catch (error) {
-                this.log.warn(error, `Failed to broadcast ${description} to node ${peer.baseUrl}`);
-            }
-        }
-    }
     async broadcastSelf() {
         this.log.info(`Broadcasting self to peers`);
         // Let the peers know about this node.
@@ -119,19 +139,8 @@ export class StartupService {
         const self = { baseUrl: this.baseUrl, name: this.baseUrl, publicKey: this.publicKey };
         const peerSignatureExpiry = new Date(Date.now() + SIGNATURE_LIFETIME_MS).toISOString();
         const peerSignature = signData(peerAnnouncementPayload(self, peerSignatureExpiry), this.privateKey);
-        await this.putToPeers(peers, '/peers', { ...self, signature: peerSignature, expiry: peerSignatureExpiry }, 'self');
+        await putToPeers(this.log, peers, '/peers', { ...self, signature: peerSignature, expiry: peerSignatureExpiry }, 'self');
         this.log.info(`Broadcasted self to ${peers.length} peers`);
-        this.log.info(`Broadcasting resources to peers`);
-        // Let the peers know about the resources available on this node.
-        const resources = await this.service.resourceRepository.getInternalResources();
-        const resourceSignatureExpiry = new Date(Date.now() + SIGNATURE_LIFETIME_MS).toISOString();
-        const resourceSignature = signData(resourceAnnouncementPayload(resources, resourceSignatureExpiry), this.privateKey);
-        await this.putToPeers(peers, '/all-resources', {
-            publicKey: this.publicKey,
-            resources,
-            expiry: resourceSignatureExpiry,
-            signature: resourceSignature,
-        }, 'resources');
-        this.log.info(`Broadcasted ${resources.length} resources to ${peers.length} peers`);
+        await announceResources(this.log, this.service);
     }
 }

package/dist/tests/contract/repository.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repository.test.d.ts.map

package/dist/tests/contract/repository.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.test.d.ts","sourceRoot":"","sources":["../../../src/tests/contract/repository.test.ts"],"names":[],"mappings":""}

package/dist/tests/contract/repository.test.js

@@ -0,0 +1,68 @@
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
+import { ContractRepository } from "../../contract/repository.js";
+import { DIALECTS, openTestDatabase } from "../helpers.js";
+function contract(version, overrides = {}) {
+    return {
+        path: "com.example",
+        name: "Sum",
+        version,
+        source: `contract com.example.Sum@${version}(a: int32): int32 { return a }`,
+        parameters: [{ name: "a", type: "int32" }],
+        returnType: "int32",
+        ownerOrganizationId: "org_a",
+        description: null,
+        ...overrides,
+    };
+}
+describe.each(DIALECTS)("ContractRepository (%s)", (dialect) => {
+    let db;
+    let repository;
+    beforeEach(async () => {
+        db = await openTestDatabase(dialect);
+        repository = new ContractRepository(db);
+    });
+    afterEach(async () => {
+        await db.close();
+    });
+    test("finds the latest version by comparing versions numerically", async () => {
+        for (const version of ["1", "1.10", "1.9"]) {
+            expect(await repository.save(contract(version))).toEqual({ ok: true });
+        }
+        expect(await repository.latest("com.example", "Sum")).toMatchObject({ version: "1.10", parameters: [{ name: "a", type: "int32" }], returnType: "int32" });
+        expect(await repository.latest("com.example", "Other")).toBeUndefined();
+        expect((await repository.allLatest()).map(c => c.version)).toEqual(["1.10"]);
+    });
+    test("keeps versions immutable", async () => {
+        await repository.save(contract("1"));
+        expect(await repository.save(contract("1", { source: "changed" }))).toEqual({ ok: false, refused: "version_exists" });
+        expect((await repository.latest("com.example", "Sum"))?.source).toContain("@1(");
+    });
+    test("gives every version to the first deployer's organization, and lets the admin add versions", async () => {
+        await repository.save(contract("1"));
+        expect(await repository.save(contract("2", { ownerOrganizationId: "org_b" }))).toEqual({ ok: false, refused: "owned_by_another" });
+        expect(await repository.save(contract("2", { ownerOrganizationId: null }))).toEqual({ ok: true });
+        expect(await repository.owner("com.example", "Sum")).toBe("org_a");
+        expect((await repository.latest("com.example", "Sum"))?.ownerOrganizationId).toBe("org_a");
+    });
+    test("an admin's contract belongs to no organization", async () => {
+        await repository.save(contract("1", { ownerOrganizationId: null }));
+        expect(await repository.owner("com.example", "Sum")).toBeNull();
+        expect(await repository.save(contract("2", { ownerOrganizationId: "org_b" }))).toEqual({ ok: false, refused: "owned_by_another" });
+    });
+    test("deletes one version or all of them", async () => {
+        await repository.save(contract("1"));
+        await repository.save(contract("2"));
+        expect(await repository.delete("com.example", "Sum", "2")).toBe(true);
+        expect((await repository.latest("com.example", "Sum"))?.version).toBe("1");
+        expect(await repository.delete("com.example", "Sum")).toBe(true);
+        expect(await repository.owner("com.example", "Sum")).toBeUndefined();
+        expect(await repository.delete("com.example", "Sum")).toBe(false);
+    });
+    test("lists every version a page at a time", async () => {
+        await repository.save(contract("1"));
+        await repository.save(contract("2"));
+        await repository.save(contract("1", { name: "Product" }));
+        expect((await repository.list(0, 2)).map(c => `${c.name}@${c.version}`)).toEqual(["Product@1", "Sum@1"]);
+        expect((await repository.list(2, 2)).map(c => `${c.name}@${c.version}`)).toEqual(["Sum@2"]);
+    });
+});

package/dist/tests/contract/routes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routes.test.d.ts.map

package/dist/tests/contract/routes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.test.d.ts","sourceRoot":"","sources":["../../../src/tests/contract/routes.test.ts"],"names":[],"mappings":""}