COMEBACKHERE

COMEBACKHERE Protocol — The Stripe for Stellar. Founded and built by dreamgene · Founder & CEO

Tooling, deployment scripts, ABIs, and integration resources for COMEBACKHERE Protocol.

Architecture

The following sequence diagram illustrates the primary payment flow.

sequenceDiagram
    actor Merchant
    actor Payer
    participant InvoiceContract
    participant TreasuryContract

    Merchant->>InvoiceContract: create_invoice(amount, expires_at)
    InvoiceContract-->>Merchant: invoice_id

    Payer->>InvoiceContract: mark_paid(invoice_id)
    InvoiceContract->>TreasuryContract: hold funds
    InvoiceContract-->>Payer: payment confirmed

    Merchant->>TreasuryContract: propose_settlement(invoice_id)
    TreasuryContract-->>Merchant: settlement_id

    Merchant->>TreasuryContract: approve_settlement(settlement_id)
    TreasuryContract->>Merchant: release payout

Loading

Workspace

• abis/: committed ABI metadata consumed by comebackhere-backend
• scripts/: deployment, verification, and ABI generation tooling
• docs/: developer guides and deployment documentation
• tests/: workspace-level integration tests

Local Development

Starting the Local Environment

Requires Docker and Docker Compose.

docker-compose up -d

This starts:

• Soroban Node: Stellar quickstart (Horizon at http://localhost:8000)
• Redis: Event consumer backing service (port 6379)

Check service health:

docker-compose ps
curl http://localhost:8000/health

docker-compose.override.yml

A docker-compose.override.yml file is included in the repository. Docker Compose [automatically merges] (https://docs.docker.com/compose/how-tos/multiple-compose-files/merge/) this file with docker-compose.yml when you run docker-compose up. The override adds the backend and frontend services so you can run the full stack locally without modifying the base compose file.

Developers commonly edit this file to:

• Point VITE_API_URL / VITE_SOROBAN_RPC to a different environment
• Adjust port mappings if the defaults conflict with other services
• Mount local source directories for hot-reloading during development

To inspect the effective compose configuration that Docker will use:

docker-compose config

Deploying Contracts Locally

cp .env.local.example .env.local
# Edit .env.local with your test keys
scripts/deploy_local.sh

Tearing Down

docker-compose down
# To also remove persistent data:
docker-compose down -v

ABI Snapshots

Committed ABI metadata in abis/ is generated from contract sources. The contract sources live in COMEBACKHERE-contracts/. Before opening a PR that changes contract behavior, refresh snapshots:

make update-abi-snapshots
# or
just snapshot

Confirm the tree is clean:

make check-abi-snapshots
# or
just check-snapshot
git diff --exit-code abis/

Deployment

cp .env.testnet.example .env.testnet
scripts/deploy_testnet.sh

After deployment, contract IDs are exported to artifacts/addresses.json (gitignored; environment-specific). See artifacts/addresses.json.example for the schema.

Mainnet deployment is intentionally manual and must go through multi-sig governance.

See docs/MAINNET_DEPLOYMENT.md for the live deployment checklist and signing ceremony.

License

MIT