dev -> main

.gitignore

@@ -3,3 +3,12 @@ node_modules
 .deployments
 # Soroban test snapshots — now committed as regression guards
 # gateway-contract/contracts/**/test_snapshots/
+zk/soroban/bls_setup/*.ptau
+
+# Backend
+backend/node_modules
+backend/dist
+backend/.env
+backend/coverage
+
+.codex

.husky/pre-push

@@ -7,8 +7,8 @@ echo "🌿 Validating branch name..."
 branch=$(git symbolic-ref --short HEAD)
 branch_regex='^(feat|fix|docs|refactor|test|chore)\/[a-z0-9][a-z0-9\-]*[a-z0-9]$'
 
-# Allow main, develop, staging to push freely
-if [ "$branch" = "main" ] || [ "$branch" = "develop" ] || [ "$branch" = "staging" ]; then
+# Allow protected integration branches to push freely
+if [ "$branch" = "main" ] || [ "$branch" = "dev" ] || [ "$branch" = "develop" ] || [ "$branch" = "staging" ]; then
     echo "✅ On protected branch '$branch' — skipping branch name check."
 else
     if echo "$branch" | grep -qE "$branch_regex"; then

README.md

@@ -1,9 +1,9 @@
 
 # 🌉 Alien Gateway
 
-[![Smart Contracts CI](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/build_test.yml/badge.svg)](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/build_test.yml)
-[![Checks](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/checks.yml/badge.svg)](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/checks.yml)
-[![ZK Circuits CI](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/zk_circuits.yml/badge.svg)](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/zk_circuits.yml)
+[![Smart Contracts CI](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/contract.yml/badge.svg)](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/contract.yml)
+[![Validator CI](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/pre-commit-validation.yml/badge.svg)](https://github.com/Alien-Protocol/Alien-Gateway/actions/workflows/pre-commit-validation.yml)
+
 
 <p align="center">
   <img 

backend/.dockerignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+npm-debug.log
+.git
+.env
+Dockerfile
+docker-compose.yml
+docker-compose.override.yml

backend/.env.example

@@ -0,0 +1,38 @@
+# --- Server Configuration ---
+PORT=3000 # The port the backend server will run on
+TYPEORM_SYNCHRONIZE=true # Auto-sync database schema (Set to false in production)
+
+# --- Database Configuration ---
+# Individual connection parameters (used by some services)
+POSTGRES_USER=alien
+POSTGRES_PASSWORD=alienpassword
+POSTGRES_DB=alien_gateway
+POSTGRES_PORT=5432
+# Full connection string used by the TypeORM data source
+DATABASE_URL=postgres://alien:alienpassword@localhost:5432/alien_gateway
+
+# --- Stellar / Soroban Configuration ---
+# RPC endpoints for interacting with the Soroban network
+STELLAR_RPC_URL=https://soroban-testnet.stellar.org
+SOROBAN_RPC_URL=https://soroban-testnet.stellar.org 
+# Network identifier for transaction signing
+STELLAR_NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
+
+# --- Smart Contract IDs ---
+CORE_CONTRACT_ID=C... # The main protocol contract address
+ESCROW_CONTRACT_ID=C... # Escrow logic contract address
+FACTORY_CONTRACT_ID=C... # Factory for creating new protocol instances
+AUCTION_CONTRACT_ID=C... # Auction mechanism contract address
+
+# --- API Authentication ---
+API_KEYS=key1,key2,key3 # Comma-separated list of valid API keys for guarding routes
+
+TYPEORM_SYNCHRONIZE=true
+PORT=3000
+
+# Logging Configuration
+LOG_LEVEL=info
+
+# --- Keeper Service (Automation) ---
+KEEPER_ENABLED=false # Toggle for background automation tasks
+KEEPER_SECRET_KEY= # Private key used by the keeper to sign transactions

backend/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+data.sqlite

backend/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

backend/Dockerfile

@@ -0,0 +1,23 @@
+# Base stage for shared configuration
+FROM node:20-alpine AS base
+WORKDIR /usr/src/app
+COPY package*.json ./
+
+# Builder stage: install all dependencies and build the app
+FROM base AS builder
+RUN npm ci
+COPY . .
+RUN npm run build
+
+# Production stage: install only production dependencies and copy built assets
+FROM base AS production
+ARG NODE_ENV=production
+ENV NODE_ENV=${NODE_ENV}
+RUN npm ci --only=production
+COPY --from=builder /usr/src/app/dist ./dist
+
+# Expose the API port
+EXPOSE 3000
+
+# Start the application
+CMD ["node", "dist/main"]

backend/README.md

@@ -0,0 +1,98 @@
+<p align="center">
+  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a>
+</p>
+
+[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
+[circleci-url]: https://circleci.com/gh/nestjs/nest
+
+  <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
+    <p align="center">
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a>
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a>
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/dm/@nestjs/common.svg" alt="NPM Downloads" /></a>
+<a href="https://circleci.com/gh/nestjs/nest" target="_blank"><img src="https://img.shields.io/circleci/build/github/nestjs/nest/master" alt="CircleCI" /></a>
+<a href="https://discord.gg/G7Qnnhy" target="_blank"><img src="https://img.shields.io/badge/discord-online-brightgreen.svg" alt="Discord"/></a>
+<a href="https://opencollective.com/nest#backer" target="_blank"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a>
+<a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a>
+  <a href="https://paypal.me/kamilmysliwiec" target="_blank"><img src="https://img.shields.io/badge/Donate-PayPal-ff3f59.svg" alt="Donate us"/></a>
+    <a href="https://opencollective.com/nest#sponsor"  target="_blank"><img src="https://img.shields.io/badge/Support%20us-Open%20Collective-41B883.svg" alt="Support us"></a>
+  <a href="https://twitter.com/nestframework" target="_blank"><img src="https://img.shields.io/twitter/follow/nestframework.svg?style=social&label=Follow" alt="Follow us on Twitter"></a>
+</p>
+  <!--[![Backers on Open Collective](https://opencollective.com/nest/backers/badge.svg)](https://opencollective.com/nest#backer)
+  [![Sponsors on Open Collective](https://opencollective.com/nest/sponsors/badge.svg)](https://opencollective.com/nest#sponsor)-->
+
+## Description
+
+[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository.
+
+## Project setup
+
+```bash
+$ npm install
+```
+
+## Compile and run the project
+
+```bash
+# development
+$ npm run start
+
+# watch mode
+$ npm run start:dev
+
+# production mode
+$ npm run start:prod
+```
+
+## Run tests
+
+```bash
+# unit tests
+$ npm run test
+
+# e2e tests
+$ npm run test:e2e
+
+# test coverage
+$ npm run test:cov
+```
+
+## Deployment
+
+When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the [deployment documentation](https://docs.nestjs.com/deployment) for more information.
+
+If you are looking for a cloud-based platform to deploy your NestJS application, check out [Mau](https://mau.nestjs.com), our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps:
+
+```bash
+$ npm install -g @nestjs/mau
+$ mau deploy
+```
+
+With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure.
+
+## Resources
+
+Check out a few resources that may come in handy when working with NestJS:
+
+- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework.
+- For questions and support, please visit our [Discord channel](https://discord.gg/G7Qnnhy).
+- To dive deeper and get more hands-on experience, check out our official video [courses](https://courses.nestjs.com/).
+- Deploy your application to AWS with the help of [NestJS Mau](https://mau.nestjs.com) in just a few clicks.
+- Visualize your application graph and interact with the NestJS application in real-time using [NestJS Devtools](https://devtools.nestjs.com).
+- Need help with your project (part-time to full-time)? Check out our official [enterprise support](https://enterprise.nestjs.com).
+- To stay in the loop and get updates, follow us on [X](https://x.com/nestframework) and [LinkedIn](https://linkedin.com/company/nestjs).
+- Looking for a job, or have a job to offer? Check out our official [Jobs board](https://jobs.nestjs.com).
+
+## Support
+
+Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
+
+## Stay in touch
+
+- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- Twitter - [@nestframework](https://twitter.com/nestframework)
+
+## License
+
+Nest is [MIT licensed](https://github.com/nestjs/nest/blob/master/LICENSE).