> For the complete documentation index, see [llms.txt](https://docs.coridor.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coridor.fun/overview/architecture.md).

# Architecture

Coridor runs on **Stellar Anchor Platform** plus a custom **coridor-server** for Xendit, rates, and the SEP-24 widget.

## System diagram

```mermaid
flowchart TB
  subgraph Clients
    DW[Demo Wallet / App wallets]
  end

  subgraph Production domains
    SEP["sep.coridor.fun<br/>Anchor Platform"]
    API["api.coridor.fun<br/>coridor-server"]
  end

  subgraph coridor_server["coridor-server"]
    WGT[SEP-24 widget]
    RATE[Rate service · CoinGecko]
    DEP[Deposit service]
    WDR[Withdraw service]
    XEN[Xendit client]
    OBS[Horizon observer]
  end

  subgraph Platform["Anchor Platform"]
    S10[SEP-10 auth]
    S24[SEP-24 transactions]
    S12[SEP-12 KYC]
    S38[SEP-38 quotes]
    DB[(PostgreSQL)]
  end

  subgraph External
    XDT[Xendit API]
    HZN[Horizon testnet]
  end

  DW -->|SEP-10 / SEP-24| SEP
  SEP -->|interactive JWT URL| WGT
  DW -->|browser| WGT
  WGT --> DEP
  WGT --> WDR
  DEP --> XEN
  WDR --> XEN
  XEN --> XDT
  XDT -->|webhook| API
  RATE --> S38
  SEP -->|callbacks / events| API
  API -->|JSON-RPC updates| Platform
  OBS --> HZN
  OBS --> WDR
  DEP -->|send USDC| HZN
  DW -->|USDC withdraw payment| HZN
  Platform --> DB
```

## Components

| Component           | Host              | Role                                                                    |
| ------------------- | ----------------- | ----------------------------------------------------------------------- |
| **Anchor Platform** | `sep.coridor.fun` | SEP-10, SEP-12, SEP-24, SEP-38; `stellar.toml`; transaction state       |
| **coridor-server**  | `api.coridor.fun` | Widget UI, Xendit, dynamic rates, platform callbacks, on-chain observer |
| **PostgreSQL**      | Internal          | Anchor transaction and KYC data                                         |
| **Kafka**           | Internal          | Platform events (callbacks)                                             |
| **Xendit**          | External          | IDR pay-in (VA, QRIS, OVO) and bank payout                              |
| **Horizon**         | External          | Classic USDC payments (withdraw detection, deposit send)                |

## Request paths

### Deposit

```
Wallet → SEP-10 → SEP-24 deposit → api.coridor.fun/sep24/interactive
  → User pays IDR (Xendit) → webhook → coridor-server → Platform
  → Distribution account sends USDC → User wallet
```

### Withdraw

```
Wallet → SEP-10 → SEP-24 withdraw → widget (bank details)
  → pending_user_transfer_start → User sends USDC + memo
  → Observer → Xendit payout → User bank
```

## Standards (SEPs)

| SEP    | Purpose                             |
| ------ | ----------------------------------- |
| SEP-1  | `stellar.toml` at `sep.coridor.fun` |
| SEP-10 | Wallet authentication               |
| SEP-12 | KYC (auto-accept on staging)        |
| SEP-24 | Interactive deposit / withdraw      |
| SEP-38 | Indicative and firm USDC/IDR rates  |

SEP-45 is disabled; classic USDC uses Horizon observer.

## Key accounts (testnet)

| Account                                                                | Purpose                           |
| ---------------------------------------------------------------------- | --------------------------------- |
| `GCACTDNRY4V7QD4M6FSPGLCR5BNANSLBHIKACRTPSZ4B75NKL66QGSVS`             | Distribution — USDC inventory     |
| USDC issuer `GATALTGTWIOT6BUDBCZM3Q4OQ4BO2COLOAZ7IYSKPLC2PMSOPPGF5V56` | Asset users trustline and receive |

## Deployment note

VPS deploy, env vars, and Docker setup live in the backend repo: [DEPLOY.md](https://github.com/demigohu/coridor/blob/main/DEPLOY.md) (not duplicated here).

## Related

* [How Coridor works](/overview/how-coridor-works.md)
* [stellar.toml & SEP](/developers/stellar.toml-and-sep.md)
* [HTTP API](/developers/http-api.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coridor.fun/overview/architecture.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.