settlekit/render.yaml
caelum0x def5b16ede chore(deploy): Colosseum Render blueprint for api, worker, checkout, dashboard and web
- render.yaml deploys the five buyer/seller services on Node 22 with every
  env var the new surfaces read (chains, routing, HyperCore, Zcash, x402/MPP,
  onchain billing, service token, Discord, fee); Node builds install only the
  app and its workspace deps (pnpm --filter <app>...). Free plans everywhere
  except the worker (Render has no free background workers: starter).
- API/worker Dockerfiles install filtered; the API runs migrations on boot
  because preDeployCommand is paid-only.
- worker boots without GitHub App / Resend / Discord credentials: those
  deliveries stay pending and emails are skipped with a warning.
- .env.example documents the service token, manage-link secret and Discord OAuth.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 21:43:12 +03:00

599 lines
18 KiB
YAML

# SettleKit — Render Blueprint (Colosseum deployment).
#
# In Render: New -> Blueprint -> connect this repo. Render provisions the
# database and the five services buyers and sellers use:
#
# settlekit-db Postgres (api + worker + checkout share it)
# settlekit-api REST API (Docker, Node 22) free
# settlekit-worker background jobs (Docker, Node 22) starter (~$7/mo):
# Render has no free background workers. The worker
# confirms payments, charges subscriptions, retries
# deliveries and sends seller webhooks; without it
# one-time checkout still works but renewals stop.
# settlekit-checkout hosted checkout + payment links (Next.js) free
# settlekit-dashboard merchant dashboard (Next.js) free
# settlekit-web marketing site + /docs/integrate (Next.js) free
#
# Every Node build installs ONLY the app and its workspace dependencies
# (`pnpm install --filter <app>...`), so no unrelated app is installed or built.
# The other apps in the repo (marketplace, docs, portal, admin, consoles) are
# not part of this deployment.
#
# `sync: false` values are filled in the Render dashboard; every chain and
# integration fails closed until configured. Secrets marked generateValue are
# created once; shared ones are copied between services with fromService.
#
# After the first deploy, set the cross-service URLs (Render shows each
# service's onrender.com URL): NEXT_PUBLIC_API_URL / SETTLEKIT_API_URL -> api,
# NEXT_PUBLIC_CHECKOUT_URL / CHECKOUT_PUBLIC_URL / ONCHAIN_BILLING_CHECKOUT_URL
# -> checkout, NEXT_PUBLIC_DASHBOARD_URL -> dashboard.
#
# NOTE: do NOT create a plain Web Service pointing at the repo root; always
# deploy via Blueprint so each service gets its own build/start commands.
databases:
- name: settlekit-db
databaseName: settlekit
user: settlekit
plan: free
services:
# ---- Backend API (Docker) -------------------------------------------------
- type: web
name: settlekit-api
runtime: docker
dockerfilePath: ./apps/api/Dockerfile
dockerContext: .
plan: free
healthCheckPath: /health
# Migrations run on container start (see apps/api/Dockerfile CMD):
# preDeployCommand is not available on the free plan.
envVars:
- key: NODE_ENV
value: "production"
- key: PORT
value: "8787"
- key: DATABASE_URL
fromDatabase:
name: settlekit-db
property: connectionString
# Signing secrets (generated once).
- key: LICENSE_TOKEN_SECRET
generateValue: true
- key: WEBHOOK_SIGNING_SECRET
generateValue: true
- key: AUTH_COOKIE_SECRET
generateValue: true
- key: FILE_DOWNLOAD_SECRET
generateValue: true
- key: API_BOOTSTRAP_KEY
generateValue: true
# Hosted checkout -> /v1/onchain-billing (subscriptions). Copied to the checkout.
- key: SETTLEKIT_SERVICE_TOKEN
generateValue: true
# Platform fee: 1%, no fixed fee (DEFAULT_FEE_SCHEDULE). Keep equal to the web's NEXT_PUBLIC_PLATFORM_FEE_*.
- key: PLATFORM_FEE_BPS
value: "100"
- key: PLATFORM_FEE_FIXED
value: "0"
- key: FILE_DOWNLOAD_BASE_URL
sync: false
- key: PROOF_EXCLUDED_ORGS
sync: false
# Arc testnet defaults (override for mainnet / another chain).
- key: ARC_CHAIN_ID
value: "5042002"
- key: ARC_RPC_URL
value: "https://rpc.testnet.arc.network"
- key: ARC_USDC_ADDRESS
value: "0x3600000000000000000000000000000000000000"
# Multi-chain payments (fail closed until set; see .env.example).
- key: SETTLEKIT_CHAIN_ENV
sync: false
- key: ENABLED_EVM_CHAINS
sync: false
- key: ETHEREUM_RPC_URL
sync: false
- key: ETHEREUM_NETWORK
sync: false
- key: ETHEREUM_MIN_CONFIRMATIONS
sync: false
- key: BASE_RPC_URL
sync: false
- key: BASE_NETWORK
sync: false
- key: BASE_MIN_CONFIRMATIONS
sync: false
- key: ARBITRUM_RPC_URL
sync: false
- key: ARBITRUM_NETWORK
sync: false
- key: ARBITRUM_MIN_CONFIRMATIONS
sync: false
- key: ROBINHOOD_RPC_URL
sync: false
- key: ROBINHOOD_NETWORK
sync: false
- key: ROBINHOOD_MIN_CONFIRMATIONS
sync: false
- key: HYPEREVM_RPC_URL
sync: false
- key: HYPEREVM_NETWORK
sync: false
- key: HYPEREVM_MIN_CONFIRMATIONS
sync: false
- key: TEMPO_RPC_URL
sync: false
- key: TEMPO_NETWORK
sync: false
- key: TEMPO_MIN_CONFIRMATIONS
sync: false
- key: SOLANA_CLUSTER
sync: false
- key: SOLANA_RPC_URL
sync: false
- key: SOLANA_USDC_MINT
sync: false
- key: ZCASH_ENABLED
sync: false
- key: ZCASH_EXPLORER_URL
sync: false
- key: BLOCKCHAIR_API_KEY
sync: false
- key: ZCASH_MIN_CONFIRMATIONS
sync: false
- key: ZCASH_QUOTE_TTL_SEC
sync: false
- key: HYPERCORE_ENABLED
sync: false
- key: HYPERCORE_NETWORK
sync: false
- key: HYPERCORE_API_URL
sync: false
# Pay with any token (Relay / LI.FI).
- key: ROUTING_ENABLED
sync: false
- key: RELAY_API_KEY
sync: false
- key: RELAY_API_URL
sync: false
- key: LIFI_ENABLED
sync: false
- key: LIFI_API_KEY
sync: false
- key: LIFI_INTEGRATOR
sync: false
- key: ROUTE_MAX_FEE_BPS
sync: false
- key: ROUTE_MAX_SLIPPAGE_BPS
sync: false
- key: ROUTE_QUOTE_TTL_SEC
sync: false
- key: ROUTE_ORIGIN_ALLOWLIST
sync: false
- key: ROUTE_APP_FEE_BPS
sync: false
- key: ROUTE_APP_FEE_RECIPIENT
sync: false
# Agent payments: x402 on every chain + MPP on Tempo.
- key: X402_PAY_TO
sync: false
- key: X402_EVM_PAY_TO
sync: false
- key: X402_SOLANA_PAY_TO
sync: false
- key: X402_NETWORKS
sync: false
- key: X402_REMOTE_FACILITATOR_URL
sync: false
- key: X402_REMOTE_FACILITATOR_API_KEY
sync: false
- key: X402_RESEARCH_PRICE
sync: false
- key: X402_RELAYER_PRIVATE_KEY
sync: false
- key: X402_FACILITATOR_NETWORKS
sync: false
- key: X402_FACILITATOR_MAX_AMOUNT
sync: false
- key: X402_FACILITATOR_ALLOWED_PAY_TO
sync: false
- key: X402_FACILITATOR_KILL
sync: false
- key: X402_FACILITATOR_TOKEN
sync: false
- key: X402_FACILITATOR_ALLOW_EXPERIMENTAL
sync: false
- key: X402_GAS_MAX_FEE_ETHEREUM
sync: false
- key: X402_GAS_DAILY_BUDGET_ETHEREUM
sync: false
- key: MPP_SECRET_KEY
sync: false
- key: MPP_TEMPO_RECIPIENT
sync: false
# Onchain billing: subscriptions, Base escrow, operator refunds.
- key: ONCHAIN_BILLING_OPERATOR_PRIVATE_KEY
sync: false
- key: ONCHAIN_BILLING_SOLANA_SECRET
sync: false
- key: ONCHAIN_BILLING_NETWORKS
sync: false
- key: ONCHAIN_BILLING_ESCROW
sync: false
- key: ONCHAIN_BILLING_CHECKOUT_URL
sync: false
- key: HYPERCORE_REFUND_PRIVATE_KEY
sync: false
# Delivery integrations (unset = pending setup / no-op).
- key: GITHUB_APP_ID
sync: false
- key: GITHUB_APP_PRIVATE_KEY
sync: false
- key: GITHUB_APP_INSTALLATION_ID
sync: false
- key: DISCORD_BOT_TOKEN
sync: false
- key: RESEND_API_KEY
sync: false
- key: EMAIL_FROM
sync: false
# Circle integrations (optional).
- key: CIRCLE_API_KEY
sync: false
- key: CIRCLE_WALLETS_API_KEY
sync: false
- key: CIRCLE_WALLETS_WALLET_ID
sync: false
- key: CIRCLE_MINT_API_KEY
sync: false
- key: GAS_STATION_API_KEY
sync: false
- key: COMPLIANCE_API_KEY
sync: false
# ---- Background worker (Docker) -------------------------------------------
# Render background workers have no free plan; starter is the cheapest.
- type: worker
name: settlekit-worker
runtime: docker
dockerfilePath: ./apps/worker/Dockerfile
dockerContext: .
plan: starter
envVars:
- key: NODE_ENV
value: "production"
- key: DATABASE_URL
fromDatabase:
name: settlekit-db
property: connectionString
# Shared with the API.
- key: WEBHOOK_SIGNING_SECRET
fromService:
name: settlekit-api
type: web
envVarKey: WEBHOOK_SIGNING_SECRET
- key: LICENSE_TOKEN_SECRET
fromService:
name: settlekit-api
type: web
envVarKey: LICENSE_TOKEN_SECRET
- key: FILE_DELIVERY_SECRET
fromService:
name: settlekit-api
type: web
envVarKey: FILE_DOWNLOAD_SECRET
- key: FILE_DELIVERY_BASE_URL
sync: false
- key: ARC_CHAIN_ID
value: "5042002"
- key: ARC_RPC_URL
value: "https://rpc.testnet.arc.network"
- key: ARC_USDC_ADDRESS
value: "0x3600000000000000000000000000000000000000"
# Multi-chain payments (same values as the API).
- key: SETTLEKIT_CHAIN_ENV
sync: false
- key: ENABLED_EVM_CHAINS
sync: false
- key: ETHEREUM_RPC_URL
sync: false
- key: ETHEREUM_NETWORK
sync: false
- key: ETHEREUM_MIN_CONFIRMATIONS
sync: false
- key: BASE_RPC_URL
sync: false
- key: BASE_NETWORK
sync: false
- key: BASE_MIN_CONFIRMATIONS
sync: false
- key: ARBITRUM_RPC_URL
sync: false
- key: ARBITRUM_NETWORK
sync: false
- key: ARBITRUM_MIN_CONFIRMATIONS
sync: false
- key: ROBINHOOD_RPC_URL
sync: false
- key: ROBINHOOD_NETWORK
sync: false
- key: ROBINHOOD_MIN_CONFIRMATIONS
sync: false
- key: HYPEREVM_RPC_URL
sync: false
- key: HYPEREVM_NETWORK
sync: false
- key: HYPEREVM_MIN_CONFIRMATIONS
sync: false
- key: TEMPO_RPC_URL
sync: false
- key: TEMPO_NETWORK
sync: false
- key: TEMPO_MIN_CONFIRMATIONS
sync: false
- key: SOLANA_CLUSTER
sync: false
- key: SOLANA_RPC_URL
sync: false
- key: SOLANA_USDC_MINT
sync: false
- key: ZCASH_ENABLED
sync: false
- key: ZCASH_EXPLORER_URL
sync: false
- key: BLOCKCHAIR_API_KEY
sync: false
- key: ZCASH_MIN_CONFIRMATIONS
sync: false
- key: ZCASH_QUOTE_TTL_SEC
sync: false
- key: HYPERCORE_ENABLED
sync: false
- key: HYPERCORE_NETWORK
sync: false
- key: HYPERCORE_API_URL
sync: false
# Route watching (same values as the API).
- key: ROUTING_ENABLED
sync: false
- key: RELAY_API_KEY
sync: false
- key: RELAY_API_URL
sync: false
- key: LIFI_ENABLED
sync: false
- key: LIFI_API_KEY
sync: false
- key: LIFI_INTEGRATOR
sync: false
- key: ROUTE_MAX_FEE_BPS
sync: false
- key: ROUTE_MAX_SLIPPAGE_BPS
sync: false
- key: ROUTE_QUOTE_TTL_SEC
sync: false
- key: ROUTE_ORIGIN_ALLOWLIST
sync: false
- key: ROUTE_APP_FEE_BPS
sync: false
- key: ROUTE_APP_FEE_RECIPIENT
sync: false
# Onchain billing (same values as the API) - the worker charges every renewal.
- key: ONCHAIN_BILLING_OPERATOR_PRIVATE_KEY
sync: false
- key: ONCHAIN_BILLING_SOLANA_SECRET
sync: false
- key: ONCHAIN_BILLING_NETWORKS
sync: false
- key: ONCHAIN_BILLING_ESCROW
sync: false
- key: ONCHAIN_BILLING_CHECKOUT_URL
sync: false
- key: HYPERCORE_REFUND_PRIVATE_KEY
sync: false
# Delivery + email (optional: unset = pending setup, emails skipped).
- key: GITHUB_APP_ID
sync: false
- key: GITHUB_APP_PRIVATE_KEY
sync: false
- key: GITHUB_APP_INSTALLATION_ID
sync: false
- key: DISCORD_BOT_TOKEN
sync: false
- key: RESEND_API_KEY
sync: false
- key: EMAIL_FROM
sync: false
# Payout reconcile (optional).
- key: CIRCLE_WALLETS_API_KEY
sync: false
- key: CIRCLE_WALLETS_WALLET_ID
sync: false
# ---- Checkout (buyers: pay, subscribe, manage) ------------------------------
- type: web
name: settlekit-checkout
runtime: node
plan: free
buildCommand: corepack enable && pnpm install --frozen-lockfile --filter settlekit --filter "@settlekit/checkout-app..." && pnpm --filter "@settlekit/checkout-app..." build
# `next start` must bind Render's injected $PORT.
startCommand: pnpm --filter @settlekit/checkout-app exec next start -p $PORT
envVars:
- key: NODE_VERSION
value: "22"
- key: NODE_ENV
value: "production"
- key: DATABASE_URL
fromDatabase:
name: settlekit-db
property: connectionString
- key: CHECKOUT_PUBLIC_URL
sync: false
- key: SETTLEKIT_API_URL
sync: false
- key: NEXT_PUBLIC_API_URL
sync: false
# Subscriptions: same token as the API; the checkout calls /v1/onchain-billing server-side.
- key: SETTLEKIT_SERVICE_TOKEN
fromService:
name: settlekit-api
type: web
envVarKey: SETTLEKIT_SERVICE_TOKEN
- key: CHECKOUT_MANAGE_SECRET
generateValue: true
- key: CHECKOUT_DELIVERY_SECRET
generateValue: true
- key: CHECKOUT_DOWNLOAD_BASE
sync: false
- key: ARC_CHAIN_ID
value: "5042002"
- key: ARC_RPC_URL
value: "https://rpc.testnet.arc.network"
- key: ARC_USDC_ADDRESS
value: "0x3600000000000000000000000000000000000000"
# Multi-chain payments (same values as the API).
- key: SETTLEKIT_CHAIN_ENV
sync: false
- key: ENABLED_EVM_CHAINS
sync: false
- key: ETHEREUM_RPC_URL
sync: false
- key: ETHEREUM_NETWORK
sync: false
- key: ETHEREUM_MIN_CONFIRMATIONS
sync: false
- key: BASE_RPC_URL
sync: false
- key: BASE_NETWORK
sync: false
- key: BASE_MIN_CONFIRMATIONS
sync: false
- key: ARBITRUM_RPC_URL
sync: false
- key: ARBITRUM_NETWORK
sync: false
- key: ARBITRUM_MIN_CONFIRMATIONS
sync: false
- key: ROBINHOOD_RPC_URL
sync: false
- key: ROBINHOOD_NETWORK
sync: false
- key: ROBINHOOD_MIN_CONFIRMATIONS
sync: false
- key: HYPEREVM_RPC_URL
sync: false
- key: HYPEREVM_NETWORK
sync: false
- key: HYPEREVM_MIN_CONFIRMATIONS
sync: false
- key: TEMPO_RPC_URL
sync: false
- key: TEMPO_NETWORK
sync: false
- key: TEMPO_MIN_CONFIRMATIONS
sync: false
- key: SOLANA_CLUSTER
sync: false
- key: SOLANA_RPC_URL
sync: false
- key: SOLANA_USDC_MINT
sync: false
- key: ZCASH_ENABLED
sync: false
- key: ZCASH_EXPLORER_URL
sync: false
- key: BLOCKCHAIR_API_KEY
sync: false
- key: ZCASH_MIN_CONFIRMATIONS
sync: false
- key: ZCASH_QUOTE_TTL_SEC
sync: false
- key: HYPERCORE_ENABLED
sync: false
- key: HYPERCORE_NETWORK
sync: false
- key: HYPERCORE_API_URL
sync: false
# Pay with any token.
- key: ROUTING_ENABLED
sync: false
- key: RELAY_API_KEY
sync: false
- key: RELAY_API_URL
sync: false
- key: LIFI_ENABLED
sync: false
- key: LIFI_API_KEY
sync: false
- key: LIFI_INTEGRATOR
sync: false
- key: ROUTE_MAX_FEE_BPS
sync: false
- key: ROUTE_MAX_SLIPPAGE_BPS
sync: false
- key: ROUTE_QUOTE_TTL_SEC
sync: false
- key: ROUTE_ORIGIN_ALLOWLIST
sync: false
- key: ROUTE_APP_FEE_BPS
sync: false
- key: ROUTE_APP_FEE_RECIPIENT
sync: false
# Delivery: GitHub App, Discord bot + OAuth app (Connect Discord).
- key: GITHUB_APP_ID
sync: false
- key: GITHUB_APP_PRIVATE_KEY
sync: false
- key: GITHUB_APP_INSTALLATION_ID
sync: false
- key: DISCORD_BOT_TOKEN
sync: false
- key: DISCORD_CLIENT_ID
sync: false
- key: DISCORD_CLIENT_SECRET
sync: false
# ---- Merchant dashboard -----------------------------------------------------
- type: web
name: settlekit-dashboard
runtime: node
plan: free
buildCommand: corepack enable && pnpm install --frozen-lockfile --filter settlekit --filter "@settlekit/dashboard..." && pnpm --filter "@settlekit/dashboard..." build
# `next start` must bind Render's injected $PORT.
startCommand: pnpm --filter @settlekit/dashboard exec next start -p $PORT
envVars:
- key: NODE_VERSION
value: "22"
- key: NEXT_PUBLIC_API_URL
sync: false
- key: NEXT_PUBLIC_CHECKOUT_URL
sync: false
- key: NEXT_PUBLIC_DISCORD_CLIENT_ID
sync: false
# ---- Marketing site + integration docs --------------------------------------
- type: web
name: settlekit-web
runtime: node
plan: free
buildCommand: corepack enable && pnpm install --frozen-lockfile --filter settlekit --filter "@settlekit/web..." && pnpm --filter "@settlekit/web..." build
# `next start` must bind Render's injected $PORT.
startCommand: pnpm --filter @settlekit/web exec next start -p $PORT
envVars:
- key: NODE_VERSION
value: "22"
- key: NEXT_PUBLIC_API_URL
sync: false
- key: NEXT_PUBLIC_CHECKOUT_URL
sync: false
- key: NEXT_PUBLIC_DASHBOARD_URL
sync: false
- key: NEXT_PUBLIC_DOCS_URL
sync: false
# Mirrors the API's platform fee (1%, no fixed fee).
- key: NEXT_PUBLIC_PLATFORM_FEE_BPS
value: "100"
- key: NEXT_PUBLIC_PLATFORM_FEE_FIXED
value: "0"