Files
proxmox/phoenix-deploy-api
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00
..

Phoenix Deploy API

Gitea webhook receiver and deploy endpoint stub for Gitea → Phoenix deployment integration.

Endpoints

Method Path Description
POST /webhook/gitea Receives Gitea push/tag/PR webhooks
POST /api/deploy Deploy request (repo, branch, target)
GET /health Health check

Environment

Copy .env.example to .env and set GITEA_TOKEN (and optionally PHOENIX_DEPLOY_SECRET).

Variable Default Description
PORT 4001 Listen port
GITEA_URL https://gitea.d-bis.org Gitea instance URL
GITEA_TOKEN Token for commit status API
PHOENIX_DEPLOY_SECRET Optional secret for webhook/deploy auth

Gitea Webhook Configuration

In Gitea: Repository → Settings → Webhooks → Add Webhook

  • URL: https://phoenix-api-host/api/webhook/gitea (or your Phoenix API URL)
  • Content type: application/json
  • Events: Push events, Tag creation (and optionally Pull requests)
  • Secret: Optional, set PHOENIX_DEPLOY_SECRET to match

Deploy API (Trigger from Gitea Actions)

curl -X POST "https://phoenix-api-host/api/deploy" \
  -H "Authorization: Bearer $PHOENIX_DEPLOY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repo":"d-bis/proxmox","branch":"main","sha":"abc123","target":"default"}'

Integration with Sankofa Phoenix

This service is a standalone stub. Full deployment logic should be implemented in the Sankofa Phoenix API (VMID 8600). Migrate the webhook handler and deploy logic into the Phoenix API when ready.

Run

npm install
GITEA_TOKEN=xxx npm start