> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mojdelez.si/llms.txt
> Use this file to discover all available pages before exploring further.

# Pregled arhitekture

> Kako se povezujejo pametne pogodbe, oracle in spletna stran.

## Komponente in tok podatkov

```mermaid theme={null}
flowchart TD
    V[PulseChain validatorji<br/>block.prevrandao] --> O[EntropyOracle]
    U[UORS overovitelj] -->|registerCommitment| Z[ZKVerifier]
    O -->|entropyHash → nonce| Z
    S[Stranka] -->|ZK proof + 12 besed| Z
    Z -->|verifyAndMint| T[RWAToken PRC-20]
    T --> M[Marketplace]
    S --> M
```

## Vloge

<AccordionGroup>
  <Accordion title="EntropyOracle">
    Periodično zapisuje naključnost iz PulseChain validatorjev (`block.prevrandao`). Vsak zapis ima `entropyHash`, iz katerega se izračuna `nonce`. Teče kot cron na Neoserv.
  </Accordion>

  <Accordion title="UORSRegistry">
    Register pooblaščenih overoviteljev. Samo avtoriziran UORS lahko registrira commitment za novo sredstvo.
  </Accordion>

  <Accordion title="ZKVerifier">
    Groth16 verifier. Hrani registrirane commitmente in jih ob mintu označi kot uporabljene (`commitmentUsed`). Mint poteče prek `verifyAndMint`.
  </Accordion>

  <Accordion title="RWAToken (PRC-20)">
    Standardni žeton, ki predstavlja lastniške deleže realnega sredstva. Izdaja je dovoljena samo prek ZKVerifierja.
  </Accordion>

  <Accordion title="Marketplace">
    Kupovanje/prodajanje RWA žetonov. Plačilni token na testnetu je **USDC**.
  </Accordion>
</AccordionGroup>

## Infrastruktura

| Plast             | Tehnologija                                         |
| ----------------- | --------------------------------------------------- |
| Pametne pogodbe   | Solidity ^0.8.24, OpenZeppelin v5                   |
| ZK                | Circom 2.1.6, snarkjs (Groth16), circomlib Poseidon |
| Oracle            | Node.js, ethers v6 — **cron na Neoserv**            |
| Frontend          | Vanilla HTML/JS/CSS, ethers v6 (CDN)                |
| Gostovanje strani | Neoserv (cPanel/Apache)                             |
| Shramba datotek   | IPFS / Pinata                                       |