@absol-labs/agent 0.11.0 → 0.12.0-rc.2

package/src/x402-opener/facilitator-entry.ts

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { startOpenerFacilitatorServerFromEnv } from "./facilitator-server.js";
+
+/**
+ * Runnable entrypoint for the Metrik x402 v2 opener facilitator
+ * (metrik-agent#116). Reads all configuration from the environment (see
+ * `parseOpenerFacilitatorEnvConfig`) and refuses to start unless it is
+ * explicitly enabled and fully configured.
+ *
+ * Start with: `metrik-x402-opener-facilitator` (or `pnpm x402-opener:facilitator`).
+ */
+async function main(): Promise<void> {
+  const server = await startOpenerFacilitatorServerFromEnv();
+  const { binding } = server;
+  console.error(
+    `[metrik-opener-facilitator] listening on port ${server.boundPort} — chain ${binding.chainId}, ` +
+      `factory ${binding.factory}, escrow ${binding.escrow}, token ${binding.usdc}, relayer ${binding.relayer}. ` +
+      (binding.upfront === undefined
+        ? "Upfront (minimum-charge) opener: OFF. "
+        : `Upfront (minimum-charge) opener factory ${binding.upfront.factory} (implementation ${binding.upfront.implementation}): ON — its non-refundable upfrontAmount is paid to the seller at settlement, only price - upfrontAmount is escrowed and refundable. `) +
+      "Every payment settles through the opener factory's deployAndSettle (an escrow stream for the metered part); nothing is ever transferred to payTo directly. " +
+      (server.refundRelayEnabled
+        ? "Gasless refund relay ON at /streams/:streamId (close needs the payer's signature; reclaim is permissionless and pays only payerOf). There is no automatic refund: nothing is sent unless an endpoint is called."
+        : "Gasless refund relay OFF (METRIK_OPENER_FACILITATOR_REFUND_RELAY=0): a gateway will refuse to quote through this facilitator."),
+  );
+
+  const shutdown = (signal: string) => {
+    console.error(
+      `[metrik-opener-facilitator] ${signal} received — shutting down`,
+    );
+    server
+      .close()
+      .then(() => process.exit(0))
+      .catch(() => process.exit(1));
+  };
+  process.on("SIGINT", () => shutdown("SIGINT"));
+  process.on("SIGTERM", () => shutdown("SIGTERM"));
+}
+
+main().catch((error) => {
+  // Only the message: never a stack or config object that could carry the key.
+  console.error(
+    error instanceof Error
+      ? error.message
+      : "failed to start the Metrik x402 opener facilitator",
+  );
+  process.exit(1);
+});