Contract Address Details

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "./AdminZamik.sol";

interface IKYCWhitelist {
    function isWhitelisted(address account) external view returns (bool);
}

interface IUORSRegistry {
    function authorizedUORS(address operater) external view returns (bool);
}

/**
 * @title RWAToken
 * @notice PRC-20 token representing a Real World Asset on PulseChain
 * @dev Backed by verified off-chain data stored on IPFS.
 *      Minting requires a valid ZK proof from ZKVerifier.
 *      Transfer fee: 0.5% ob vsakem transferu → feeRecipient (platforma).
 *
 *      OPCIJSKA KYC transfer-restrikcija (permissioned token):
 *        - če je `kyc` nastavljen (!= address(0)), morata biti POŠILJATELJ in
 *          PREJEMNIK na KYC beli listi (izjeme: mint, burn, fee-leg na feeRecipient).
 *        - To prepreči, da bi RWA pristal na nepreverjeni denarnici (zahteva, ki jo
 *          regulacija običajno postavlja finančnim instrumentom — MiFID II/ZTFI-1).
 *        - POMEMBNO: naslov Marketplace pogodbe (escrow listingov/ponudb) mora biti
 *          na beli listi, sicer list()/buy()/acceptOffer() padejo.
 *        - Privzeto IZKLOPLJENO (kyc == address(0)) → navaden prosto-prenosljiv ERC-20.
 */
/**
 * @notice Nastavitve novega zetona v ENI strukturi.
 * @dev Ne zaradi lepote: devet locenih parametrov konstruktorja je tovarno
 *      pognalo v "stack too deep" (Groth16 assembly + `new` z devetimi argumenti).
 *      Struktura gre v pomnilnik namesto na sklad.
 */
struct NastavitveZetona {
    string  ime;
    string  simbol;
    string  metapodatkiCID;
    uint256 vrednostUSD;
    address zkVerifier;
    address entropyOracle;
    address feeRecipient;   // NIKOLI privzeto msg.sender — glej opombo pri konstruktorju
    address kyc;            // 0x0 = brez omejitve, a mora biti napisano izrecno
    address lastnik;
    address uors;           // UORSRegistry — kdo sme sredstvo zamrzniti (glej spodaj)
    address overitelj;      // UORS operater, ki je sredstvo overil — glej `samoOveritelj`
}

contract RWAToken is ERC20, Ownable, AdminZamik {
    string public assetMetadataCID;
    uint256 public assetValueUSD;
    address public zkVerifier;
    address public entropyOracle;

    // --- Provizije ---
    uint256 public constant TRANSFER_FEE_BPS = 50;   // 0,5% = 50 basis points
    address public feeRecipient;                       // prejemnik provizij (platforma)

    // ── Kdo je sredstvo overil ─────────────────────────────────────────────────
    //
    //  Cenitev sme spremeniti SAMO ta naslov. Cenitev je izjava o vrednosti
    //  tujega premozenja in doloca ceno prve prodaje; odgovornost zanjo nosi
    //  tisti overitelj, ki je sredstvo overil, ne katerikoli drug.
    //
    //  Zapise ga tovarna ob nastanku (`msg.sender` v `ustvariSredstvo`), zato je
    //  `immutable`: naknadno ga ne more prestaviti nihce, tudi lastnik ne.
    address public immutable overitelj;

    // ── Prvotni lastnik in enkratnost kovanja ─────────────────────────────────
    //
    //  `prvotniLastnik` je naslov, ki je prejel prvo (in edino) kovanje tega
    //  sredstva. Trznica iz njega izpelje, ali je oglas PRIMARNI: primarna je
    //  prodaja tistega, ki je sredstvo dobil ob tokenizaciji, in samo zanjo velja
    //  omejitev, da mora biti cena enaka overjeni cenitvi. Ce bi to zastavico
    //  vpisoval prodajalec sam, bi bila omejitev obvod z enim argumentom.
    //
    //  Vrednost `address(0)` pomeni "se ni skovano" in hkrati sluzi kot kljucavnica:
    //  kovanje je mogoce natanko enkrat. Enkratnost ni kozmetika — cena na primarnem
    //  trgu je `cenitev / stevilo enot`, zato bi vsako naknadno kovanje tiho premaknilo
    //  razmerje "ena enota = 1/N sredstva" vsem dosedanjim imetnikom.
    address public prvotniLastnik;

    //  Dovoljenje za en sam `mintFee`, ki sledi kovanju. Ni javno: je notranje
    //  stanje ene transakcije, ne podatek o sredstvu.
    bool private provizijaOdprta;
    /// @dev Kolicina, skovana prvotnemu lastniku — zgornja meja za provizijo ob kovanju.
    uint256 private skovanoLastniku;

    // --- KYC transfer-restrikcija (opcijska) ---
    address public kyc;  // KYCWhitelist; če address(0), je restrikcija IZKLOPLJENA

    // ─────────────────────────────────────────────────────────────────────────
    //  ZAPORA PRENOSA — varovalo za kupca
    //
    //  Kovanje v denarnico lastnika sredstva je takojsnje; PRENOS komurkoli
    //  drugemu (in s tem oglas na trznici) je mogoc sele po `aktivenOd`.
    //  V tem oknu je sredstvo javno vidno in ga je mogoce ustaviti, preden je
    //  prenosljivo tretji osebi.
    //
    //  Omejitev je v zetonu, ne v Marketplaceu: neposreden `transfer` iz
    //  denarnice bi jo sicer obsel.
    //
    //  ⚠️ Dolzino zapore doloca VERIGA, ne clovek — enako kot `zamik()`:
    //     na produkcijski verigi 48 ur, drugod 10 minut, z ISTO bajtno kodo.
    //     Prej je bila `constant` 48 ur povsod, kar je na testnetu pomenilo dvodnevno
    //     cakanje pri vsakem preizkusu. Fiksna vrednost, ki bi jo bilo treba pred
    //     produkcijo rocno vrniti, bi bila zanasanje na spomin: tako je nihce ne more
    //     skrajsati in nihce je ne more pozabiti prestaviti nazaj.
    //
    //  ⚠️ Ime NI ZAPORA_PRENOSA (velike crke): vrednost ni konstanta, ker je odvisna
    //     od verige. Ime, ki obljublja konstanto, bi bilo napacno poimenovana stevilka.
    // ─────────────────────────────────────────────────────────────────────────
    function _zaporaPrenosa() internal view returns (uint256) {
        return block.chainid == MAINNET ? 48 hours : 10 minutes;
    }

    /// @notice Koliko casa po nastanku sredstvo se ni prenosljivo. Bere ga stran,
    ///         da lahko pove pravo stevilko na pravi verigi.
    function zaporaPrenosa() external view returns (uint256) {
        return _zaporaPrenosa();
    }

    uint256 public immutable aktivenOd;

    // ─────────────────────────────────────────────────────────────────────────
    //  ZAMRZNITEV — pravico ima izkljucno pooblasceni UORS operater
    //
    //  Obstoj sredstva potrdi UORS, zato je tudi preklic v njegovi pristojnosti.
    //  Lastnik (admin) tega zetona ne more zamrzniti; s tem bi presojal o
    //  posameznem sredstvu in prevzel del odgovornosti, ki je pri UORS.
    //
    //  Posledica, ki je del zasnove: admin posameznega sredstva ne more ustaviti.
    //  Njegova pot je sistemska — odvzem pooblastila operaterju in `pause()` na
    //  ZKVerifierju oziroma Marketplaceu.
    // ─────────────────────────────────────────────────────────────────────────
    address public immutable uors;      // UORSRegistry
    bool public zamrznjen;

    event Zamrznjeno(address indexed kdo);
    event Odmrznjeno(address indexed kdo);

    mapping(bytes32 => bool) public usedProofs;

    // Dogodka za spremembo opisa ni: `assetMetadataCID` je nespremenljiv.
    /// @notice Sprememba prijavljene vrednosti sredstva; oddana ob vsaki spremembi,
    ///         da je razvidna iz dnevnika verige in ne le iz stanja pogodbe.
    event AssetValueUpdated(uint256 newValueUSD);
    event TokensMinted(address indexed to, uint256 amount, bytes32 proofHash);
    /// @notice Zapisan prvotni lastnik — iz njega trznica izpelje primarni oglas.
    event PrvotniLastnikZapisan(address indexed lastnik);
    event TransferFeeCollected(address indexed from, address indexed to, uint256 fee);
    event FeeRecipientUpdated(address indexed newRecipient);
    event KycUpdated(address indexed newKyc);

    /**
     * @notice `feeRecipient`, `kyc` in `lastnik` se nastavijo v konstruktorju,
     *         ne po postavitvi.
     * @dev Nobena od teh vrednosti nima privzetka: `feeRecipient` in `lastnik`
     *      sta obvezna (`require` spodaj), `kyc` pa je lahko `address(0)` samo,
     *      ce je to izrecno podano. Zeton brez KYC omejitve je s tem zavestna
     *      izbira ob postavitvi in ne posledica neizvedenega naknadnega koraka.
     */
    constructor(NastavitveZetona memory n)
        ERC20(n.ime, n.simbol)
        Ownable(n.lastnik)
    {
        require(n.zkVerifier   != address(0), "ZKVerifier je nujen");
        require(n.feeRecipient != address(0), "feeRecipient je nujen");
        require(n.lastnik      != address(0), "Lastnik je nujen");
        require(n.uors         != address(0), "UORSRegistry je nujen");
        assetMetadataCID = n.metapodatkiCID;
        assetValueUSD    = n.vrednostUSD;
        zkVerifier       = n.zkVerifier;
        entropyOracle    = n.entropyOracle;
        feeRecipient     = n.feeRecipient;
        kyc              = n.kyc;   // sme biti 0x0, a mora biti napisano izrecno
        uors             = n.uors;
        overitelj        = n.overitelj;  // 0x0 pomeni: cenitve ne more spremeniti nihce
        aktivenOd        = block.timestamp + _zaporaPrenosa();
    }

    modifier samoUORS() {
        require(uors != address(0) && IUORSRegistry(uors).authorizedUORS(msg.sender),
                "Samo UORS operater");
        _;
    }

    /**
     * @dev Samo TISTI overitelj, ki je sredstvo overil — in samo dokler je se
     *      pooblascen. Odvzem pooblastila mu pravico takoj vzame; skrbnik s tem
     *      obdrzi veto, ne da bi dobil moznost cenitev spremeniti sam.
     *
     * ⚠️ Trije LOCENI razlogi, ne en skupen: bralec mora vedeti, ali sredstvo
     *    overitelja nima, ali ga ima in to ni on, ali pa mu je bilo pooblastilo
     *    odvzeto. Nevednost in prepoved nista isto.
     */
    modifier samoOveritelj() {
        require(overitelj != address(0), "Sredstvo nima zapisanega overitelja");
        require(msg.sender == overitelj, "Samo overitelj tega sredstva");
        require(uors != address(0) && IUORSRegistry(uors).authorizedUORS(msg.sender),
                "Overitelj ni vec pooblascen");
        _;
    }

    /// @notice Ali je sredstvo mogoce prenasati (in s tem prodajati).
    /// @dev Namenjeno strani, da lahko pove RAZLOG in odstevanje, namesto da
    ///      uporabnik dobi golo revertirano transakcijo brez pojasnila.
    function jePrenosMogoc() external view returns (bool mogoc, uint256 odKdaj, bool zamrznjeno) {
        return (block.timestamp >= aktivenOd && !zamrznjen, aktivenOd, zamrznjen);
    }

    /// @notice Zamrzne prenose tega sredstva. Takojsno — nevarnost ne caka.
    function zamrzni() external samoUORS {
        zamrznjen = true;
        emit Zamrznjeno(msg.sender);
    }

    /// @notice Odmrzne. Prav tako samo UORS: kdor je odgovoren za izjavo, jo tudi
    ///         umakne in vrne.
    function odmrzni() external samoUORS {
        zamrznjen = false;
        emit Odmrznjeno(msg.sender);
    }

    /**
     * @notice Mintanje prek ZKVerifier (brez transfer fee — to je kreacija tokenov).
     */
    function mintWithProof(address to, uint256 amount, bytes32 proofHash) external {
        require(msg.sender == zkVerifier, "Only ZK verifier");
        require(!usedProofs[proofHash], "Proof already used");
        // Sredstvo se skuje natanko enkrat. Brez te omejitve bi lahko overitelj
        // registriral novo kodo za isti zeton in obtok bi zrasel — s tem bi se
        // razmerje "ena enota = 1/N sredstva" in primarna cena premaknila vsem.
        require(prvotniLastnik == address(0), "Sredstvo je ze skovano");
        usedProofs[proofHash] = true;
        prvotniLastnik  = to;
        provizijaOdprta = true;
        skovanoLastniku = amount;
        _mint(to, amount);
        emit TokensMinted(to, amount, proofHash);
        emit PrvotniLastnikZapisan(to);
    }

    /**
     * @notice Mintanje provizije ob tokenizaciji — pokliče samo ZKVerifier.
     * @dev Brez usedProofs check — fee mint ne porabi proof.
     */
    function mintFee(address to, uint256 amount) external {
        require(msg.sender == zkVerifier, "Only ZK verifier");
        require(to != address(0), "Zero address");
        // Provizija sme nastati samo takoj za kovanjem in samo enkrat. Brez tega
        // bi bila enkratnost kovanja odvisna od tega, kako se vede DRUGA pogodba
        // (ZKVerifier), namesto da bi jo ta pogodba zagotavljala sama.
        require(provizijaOdprta, "Provizija brez kovanja");
        // Meja zneska: provizija 0,5 % od skupne kolicine je najvec 1/199 dela,
        // ki ga dobi lastnik (fee = floor(g/200), neto = g - fee  ⇒  199·fee ≤ neto).
        // Tako enkratnost in velikost obtoka drzita tudi, ce bi se ZKVerifier
        // vedel drugace, kot je predvideno.
        require(amount * 199 <= skovanoLastniku, "Provizija previsoka");
        provizijaOdprta = false;
        _mint(to, amount);
    }

    /**
     * @notice Override _update: ob vsakem transferu (ne mint/burn) zaračuna 0,5% fee.
     * @dev OZ v5 uporablja _update namesto _transfer/_beforeTokenTransfer.
     *      Fee se ne zaračuna pri: mint (from==0), burn (to==0),
     *      feeRecipient transakcijah (izogne se loop-u).
     */
    function _update(address from, address to, uint256 amount) internal override {
        bool isMint = (from == address(0));
        bool isBurn = (to == address(0));

        // --- KYC transfer-restrikcija (opcijska; aktivna le če kyc != address(0)) ---
        if (kyc != address(0)) {
            // Prejemnik mora biti preverjen (izjema: burn). Tudi feeRecipient je
            // stranka kot vsaka druga in mora biti na beli listi; provizija ob
            // prenosu gre mimo te preverbe, ker je zapisana s super._update.
            if (!isBurn) {
                require(IKYCWhitelist(kyc).isWhitelisted(to), "Prejemnik ni KYC preverjen");
            }
            // Pošiljatelj mora biti preverjen (izjema: mint).
            if (!isMint) {
                require(IKYCWhitelist(kyc).isWhitelisted(from), "Posiljatelj ni KYC preverjen");
            }
        }

        // --- Zapora prenosa in zamrznitev ---
        // Mint (from == 0) je dovoljen takoj: lastnik sredstva ni ogrozen, ker
        // nihce se nicesar ni placal. Vse ostalo caka na aktivacijo.
        if (!isMint) {
            require(!zamrznjen, "Sredstvo je zamrznjeno");
            require(block.timestamp >= aktivenOd, "Sredstvo se ni aktivno za prenos");
        }

        // Mint, burn ali fee-related prenos → brez dodatnega fee
        if (isMint || isBurn || from == feeRecipient || to == feeRecipient) {
            super._update(from, to, amount);
            return;
        }

        uint256 fee = amount * TRANSFER_FEE_BPS / 10_000;
        uint256 net = amount - fee;

        super._update(from, feeRecipient, fee);  // 0,5% → platforma
        super._update(from, to, net);             // 99,5% → prejemnik
        emit TransferFeeCollected(from, to, fee);
    }

    // --- Admin ---

    // Vse spodnje spremembe tecejo prek javne napovedi in casovnega zamika
    // (glej AdminZamik.sol). Imetnik zetona tako vsako spremembo vidi priti in
    // ima cas izstopiti — namesto da se zbudi v drugacen instrument.

    /// @notice Nastavi KYCWhitelist za transfer-restrikcijo. address(0) = izklopljeno.
    /// @dev POZOR: ob vklopu mora biti naslov Marketplace pogodbe na beli listi (escrow).
    function napoviSetKyc(address _kyc) external onlyOwner {
        _napovej(keccak256(abi.encode("setKyc", _kyc)), "RWAToken.setKyc");
    }

    function setKyc(address _kyc) external onlyOwner {
        _porabi(keccak256(abi.encode("setKyc", _kyc)), "RWAToken.setKyc");
        kyc = _kyc;
        emit KycUpdated(_kyc);
    }

    function napoviSetFeeRecipient(address _feeRecipient) external onlyOwner {
        require(_feeRecipient != address(0), "Zero address");
        _napovej(keccak256(abi.encode("setFeeRecipient", _feeRecipient)), "RWAToken.setFeeRecipient");
    }

    function setFeeRecipient(address _feeRecipient) external onlyOwner {
        require(_feeRecipient != address(0), "Zero address");
        _porabi(keccak256(abi.encode("setFeeRecipient", _feeRecipient)), "RWAToken.setFeeRecipient");
        feeRecipient = _feeRecipient;
        emit FeeRecipientUpdated(_feeRecipient);
    }

    // ── Metapodatki (opis sredstva na IPFS) so NESPREMENLJIVI ──────────────────
    //
    // `assetMetadataCID` se nastavi ob postavitvi in ga ne more spremeniti nihce —
    // ne lastnik in ne UORS operater; funkcije za to ni. Imetnik zato bere isti
    // opis, na podlagi katerega je sredstvo pridobil.
    //
    // Posledici, ki sta del zasnove:
    //   1. napake v opisu ni mogoce popraviti; popravek pomeni novo sredstvo,
    //   2. vsebina zivi na IPFS in je dosegljiva, dokler je kdo pinja — CID na
    //      verigi doloca, KATERA vsebina je veljavna, ne zagotavlja pa hrambe.

    // ── Cenitev sredstva: spremeni jo lahko SAMO UORS ──────────────────────────
    //
    // `assetValueUSD` je izjava o vrednosti realnega sredstva. Za tako izjavo
    // odgovarja overitelj, ne skrbnik sistema; skrbnik lahko dejanje prepreci
    // (`pause`, odvzem pooblastila), ne more pa ga opraviti namesto njega.
    //
    // Cenitev doloca tudi ceno, po kateri je sredstvo mogoce prvic prodati, zato
    // bi pravica skrbnika pomenila, da skrbnik doloca prodajno ceno tujega
    // sredstva. Sprememba gre skozi napoved in zamik, torej je javna vnaprej.
    //
    // ⚠️ Obe funkciji morata imeti ISTO omejitev. Ce bi eno napovedoval skrbnik
    //    in drugo izvajal overitelj, bi bila polovica postopka v napacnih rokah.
    function napoviUpdateAssetValue(uint256 newValueUSD) external samoOveritelj {
        _napovej(keccak256(abi.encode("updateAssetValue", newValueUSD)), "RWAToken.updateAssetValue");
    }

    function updateAssetValue(uint256 newValueUSD) external samoOveritelj {
        _porabi(keccak256(abi.encode("updateAssetValue", newValueUSD)), "RWAToken.updateAssetValue");
        assetValueUSD = newValueUSD;
        emit AssetValueUpdated(newValueUSD);
    }

    /// @notice Onemogoceno: renounceOwnership() bi trajno ubil setKyc in
    ///         setFeeRecipient.
    function renounceOwnership() public pure override {
        revert("Renounce onemogocen");
    }
}
        

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC20/IERC20.sol)

pragma solidity >=0.4.16;

/**
 * @dev Interface of the ERC-20 standard as defined in the ERC.
 */
interface IERC20 {
    /**
     * @dev Emitted when `value` tokens are moved from one account (`from`) to
     * another (`to`).
     *
     * Note that `value` may be zero.
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /**
     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
     * a call to {approve}. `value` is the new allowance.
     */
    event Approval(address indexed owner, address indexed spender, uint256 value);

    /**
     * @dev Returns the value of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns the value of tokens owned by `account`.
     */
    function balanceOf(address account) external view returns (uint256);

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transfer(address to, uint256 value) external returns (bool);

    /**
     * @dev Returns the remaining number of tokens that `spender` will be
     * allowed to spend on behalf of `owner` through {transferFrom}. This is
     * zero by default.
     *
     * This value changes when {approve} or {transferFrom} are called.
     */
    function allowance(address owner, address spender) external view returns (uint256);

    /**
     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
     * caller's tokens.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * IMPORTANT: Beware that changing an allowance with this method brings the risk
     * that someone may use both the old and the new allowance by unfortunate
     * transaction ordering. One possible solution to mitigate this race
     * condition is to first reduce the spender's allowance to 0 and set the
     * desired value afterwards:
     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
     *
     * Emits an {Approval} event.
     */
    function approve(address spender, uint256 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the
     * allowance mechanism. `value` is then deducted from the caller's
     * allowance.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(address from, address to, uint256 value) external returns (bool);
}
          

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)

pragma solidity ^0.8.20;

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

    function _msgData() internal view virtual returns (bytes calldata) {
        return msg.data;
    }

    function _contextSuffixLength() internal view virtual returns (uint256) {
        return 0;
    }
}
          

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)

pragma solidity ^0.8.20;

import {Context} from "../utils/Context.sol";

/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * The initial owner is set to the address provided by the deployer. This can
 * later be changed with {transferOwnership}.
 *
 * This module is used through inheritance. It will make available the modifier
 * `onlyOwner`, which can be applied to your functions to restrict their use to
 * the owner.
 */
abstract contract Ownable is Context {
    address private _owner;

    /**
     * @dev The caller account is not authorized to perform an operation.
     */
    error OwnableUnauthorizedAccount(address account);

    /**
     * @dev The owner is not a valid owner account. (eg. `address(0)`)
     */
    error OwnableInvalidOwner(address owner);

    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
     */
    constructor(address initialOwner) {
        if (initialOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(initialOwner);
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        _checkOwner();
        _;
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function owner() public view virtual returns (address) {
        return _owner;
    }

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        if (owner() != _msgSender()) {
            revert OwnableUnauthorizedAccount(_msgSender());
        }
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby disabling any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        if (newOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}
          

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.5.0) (interfaces/draft-IERC6093.sol)

pragma solidity >=0.8.4;

/**
 * @dev Standard ERC-20 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-20 tokens.
 */
interface IERC20Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC20InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC20InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     * @param allowance Amount of tokens a `spender` is allowed to operate with.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC20InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC20InvalidSpender(address spender);
}

/**
 * @dev Standard ERC-721 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-721 tokens.
 */
interface IERC721Errors {
    /**
     * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in ERC-721.
     * Used in balance queries.
     * @param owner Address of the current owner of a token.
     */
    error ERC721InvalidOwner(address owner);

    /**
     * @dev Indicates a `tokenId` whose `owner` is the zero address.
     * @param tokenId Identifier number of a token.
     */
    error ERC721NonexistentToken(uint256 tokenId);

    /**
     * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param tokenId Identifier number of a token.
     * @param owner Address of the current owner of a token.
     */
    error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC721InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC721InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param tokenId Identifier number of a token.
     */
    error ERC721InsufficientApproval(address operator, uint256 tokenId);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC721InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC721InvalidOperator(address operator);
}

/**
 * @dev Standard ERC-1155 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-1155 tokens.
 */
interface IERC1155Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     * @param tokenId Identifier number of a token.
     */
    error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC1155InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC1155InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param owner Address of the current owner of a token.
     */
    error ERC1155MissingApprovalForAll(address operator, address owner);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC1155InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC1155InvalidOperator(address operator);

    /**
     * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
     * Used in batch transfers.
     * @param idsLength Length of the array of token identifiers
     * @param valuesLength Length of the array of token amounts
     */
    error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
}
          

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import "@openzeppelin/contracts/access/Ownable.sol";
import "./RWAToken.sol";

interface IZKVerifierRegistracija {
    function registrirajZeton(address zeton) external;
}

interface IUORSRegister {
    function authorizedUORS(address operater) external view returns (bool);
}

/**
 * @title RWATokenFactory
 * @notice Postavi po en ERC-20 zeton za VSAKO realno sredstvo.
 *
 * EN ZETON NA SREDSTVO
 *   Vsako sredstvo ima svojo ERC-20 pogodbo. Deleži razlicnih sredstev tako niso
 *   medsebojno zamenljivi in je vrednost (`assetValueUSD`) lastnost posameznega
 *   sredstva, ne skupna vsem. Locitev je na verigi in je z metapodatki ni mogoce
 *   nadomestiti.
 *
 * ZAKAJ TOVARNA IN NE ROCNA POSTAVITEV
 *   Postavitev zetona zahteva vec zaporednih korakov (nastavitev prejemnika
 *   provizij in KYC seznama, prenos lastnistva, registracija pri ZKVerifierju).
 *   Tovarna jih opravi v eni transakciji, zato delno izveden postopek ni mogoc.
 *
 * KAJ TOVARNA NE POCNE
 *   Ne kuje zetonov. Ti nastanejo izkljucno prek ZK dokaza v ZKVerifierju;
 *   tovarna ustvari le pogodbo brez zaloge.
 */
contract RWATokenFactory is Ownable {

    address public immutable zkVerifier;
    address public immutable entropyOracle;

    // ─────────────────────────────────────────────────────────────────────────
    //  KDO SME USTVARITI SREDSTVO
    //
    //  Sredstvo sme ustvariti izkljucno pooblasceni UORS operater (overitelj), ne
    //  lastnik te pogodbe. Ustvaritev je izjava, da dolocen predmet obstaja, je
    //  ocenjen in ima lastnika; to preverjanje opravi overitelj.
    //
    //  Lastnik pogodbe ni v poti nastanka niti kot sopodpisnik — sicer bi bil
    //  soizdajatelj in odgovornost za vsebino izjave bi bila deljena.
    // ─────────────────────────────────────────────────────────────────────────
    address public immutable uors;   // UORSRegistry

    /// Skupne nastavitve, ki jih dobi vsak nov zeton.
    address public feeRecipient;
    address public kyc;

    address[] public sredstva;
    mapping(address => bool) public jeNase;

    event SredstvoUstvarjeno(
        address indexed zeton,
        string  ime,
        string  simbol,
        uint256 vrednostUSD,
        string  metapodatkiCID
    );
    event NastavitveSpremenjene(address feeRecipient, address kyc);

    modifier samoUORS() {
        require(IUORSRegister(uors).authorizedUORS(msg.sender), "Samo UORS operater");
        _;
    }

    constructor(
        address _zkVerifier,
        address _entropyOracle,
        address _feeRecipient,
        address _kyc,
        address _lastnik,
        address _uors
    ) Ownable(_lastnik) {
        require(_zkVerifier   != address(0), "ZKVerifier je nujen");
        require(_feeRecipient != address(0), "feeRecipient je nujen");
        require(_lastnik      != address(0), "Lastnik je nujen");
        require(_uors         != address(0), "UORSRegistry je nujen");
        uors = _uors;
        zkVerifier    = _zkVerifier;
        entropyOracle = _entropyOracle;
        feeRecipient  = _feeRecipient;
        kyc           = _kyc;
    }

    /**
     * @notice Ustvari novo sredstvo — en zeton, ena stvar iz resnicnega sveta.
     * @dev Vsako sredstvo je zavesten podpis lastnika. Za regulirano dejavnost je
     *      to prednost, ne ovira: namerno dejanje na sredstvo je bolje kot tiho
     *      dodajanje v skupno posodo.
     */
    function ustvariSredstvo(
        string calldata ime,
        string calldata simbol,
        string calldata metapodatkiCID,
        uint256 vrednostUSD
    ) external samoUORS returns (address zeton) {
        require(bytes(ime).length    != 0, "Ime je nujno");
        require(bytes(simbol).length != 0, "Simbol je nujen");
        require(vrednostUSD          != 0, "Vrednost je nujna");

        zeton = address(new RWAToken(NastavitveZetona({
            ime:            ime,
            simbol:         simbol,
            metapodatkiCID: metapodatkiCID,
            vrednostUSD:    vrednostUSD,
            zkVerifier:     zkVerifier,
            entropyOracle:  entropyOracle,
            feeRecipient:   feeRecipient,
            kyc:            kyc,
            lastnik:        owner(),  // lastnik zetona = lastnik tovarne (Ledger / multisig)
            uors:           uors,     // zamrznitev sredstva sme SAMO UORS (glej RWAToken)
            // Overitelj je TISTI operater, ki sredstvo ustvarja zdaj. Zapise se
            // nespremenljivo in doloca, kdo sme pozneje spremeniti cenitev —
            // odgovornost za izjavo o vrednosti nosi tisti, ki jo je dal.
            overitelj:      msg.sender
        })));

        sredstva.push(zeton);
        jeNase[zeton] = true;

        // Sele s tem sme ZKVerifier kovati na tem zetonu.
        IZKVerifierRegistracija(zkVerifier).registrirajZeton(zeton);

        emit SredstvoUstvarjeno(zeton, ime, simbol, vrednostUSD, metapodatkiCID);
    }

    /// @notice Spremeni nastavitve za PRIHODNJE zetone. Ze ustvarjenih ne dotakne —
    ///         tam se feeRecipient in kyc spreminjata na zetonu samem, pod zamikom.
    function nastavi(address _feeRecipient, address _kyc) external onlyOwner {
        require(_feeRecipient != address(0), "feeRecipient je nujen");
        feeRecipient = _feeRecipient;
        kyc = _kyc;
        emit NastavitveSpremenjene(_feeRecipient, _kyc);
    }

    function steviloSredstev() external view returns (uint256) {
        return sredstva.length;
    }

    /// @notice Vsa sredstva naenkrat — stran jih rabi za seznam zetonov.
    function vsaSredstva() external view returns (address[] memory) {
        return sredstva;
    }

    /// @notice Onemogoceno: brez lastnika tovarna ne bi mogla vec ustvariti sredstva.
    function renounceOwnership() public pure override {
        revert("Renounce onemogocen");
    }
}
          

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import "@openzeppelin/contracts/access/Ownable.sol";

/**
 * @title AdminZamik
 * @notice Casovni zamik na nevarne admin spremembe.
 *
 * ZAKAJ TO OBSTAJA
 * ----------------
 * Owner kljuc na tej platformi NE more krasti: ne more kovati zetonov, ne more
 * premikati tujih zetonov in ne more v escrow. Kar PA lahko, je tiho zamenjati
 * nastavitve pod nogami uporabnikov — KYC listo, placilni token, prijavljeno
 * vrednost sredstva.
 *
 * Vsi trije so napadi, ki jih je mogoce VIDETI VNAPREJ. Zato jih ne branimo z
 * multisigom (ki varuje lastnika kljuca), ampak s casovnim zamikom (ki varuje
 * UPORABNIKA): sprememba se mora najprej javno napovedati, sele po zamiku jo je
 * mogoce izvesti. Uporabnik ima ves ta cas, da spremembo vidi in izstopi.
 *
 * Namenoma NI zunanje timelock pogodbe kot lastnika. Tak vzorec doda tveganje
 * nedosegljivosti: ce lastniku kdaj ne uspe sestaviti transakcije skozi tujo
 * pogodbo, so kontrakti zamrznjeni za vedno. Tu je zamik vgrajen, lastnik pa
 * ostane navadna denarnica.
 *
 * KAJ ZAMIK NE POKRIVA (namerno)
 * ------------------------------
 *   - pause()   — zasilna zavora mora biti takojsnja, sicer ni zavora
 *   - unpause() — vrnitev v obratovanje naj bo hitra
 *   - odvzem pravice zaustavljalca — ob razkritem kljucu ga moras vreci TAKOJ
 * Nevarnost caka, zasilna zavora ne.
 */
abstract contract AdminZamik is Ownable {
    /// @notice Rok, v katerem je napoved uporabna. Po njem potece.
    /// @dev Brez tega bi stara napoved lezala na verigi kot nabita puska:
    ///      napoves nekaj neopaznega danes, izvedes cez pol leta, ko nihce vec
    ///      ne gleda. Napoved, ki ni bila izvedena v roku, je treba ponoviti.
    uint256 public constant ROK = 7 days;

    /// @notice id napovedi → cas, od katerega je izvedljiva (0 = ni napovedi)
    mapping(bytes32 => uint256) public izvedljivoOd;

    event SpremembaNapovedana(bytes32 indexed id, string kaj, uint256 izvedljivoOd, uint256 potece);
    event SpremembaIzvedena(bytes32 indexed id, string kaj);
    event SpremembaPreklicana(bytes32 indexed id, string kaj);

    /// @notice PulseChain mainnet. Edina veriga, kjer zamik varuje pravo vrednost.
    uint256 internal constant MAINNET = 369;

    /// @notice Koliko casa mora napovedana sprememba cakati, preden je izvedljiva.
    ///
    ///   mainnet (369)   48 ur      imetnik ima cas spremembo videti in izstopiti
    ///   druge verige    10 minut   razvojno okolje
    ///
    /// @dev Vrednost doloca `block.chainid`, ne nastavitev ob postavitvi. Ista
    ///      bajtna koda tako na produkcijski verigi vedno vrne 48 ur; razvojne
    ///      vrednosti ni mogoce prenesti na mainnet, niti pomotoma.
    /// @dev `virtual` zato, da lahko posamezna testna pogodba vrednost povozi.
    function zamik() public view virtual returns (uint256) {
        return block.chainid == MAINNET ? 48 hours : 10 minutes;
    }

    // ── Notranje ────────────────────────────────────────────────────────────

    /// @dev id MORA vsebovati tocne parametre spremembe, sicer bi lahko
    ///      napovedal nedolzno vrednost in izvedel skodljivo.
    function _napovej(bytes32 id, string memory kaj) internal {
        require(izvedljivoOd[id] == 0, "Ze napovedano");
        uint256 od = block.timestamp + zamik();
        izvedljivoOd[id] = od;
        emit SpremembaNapovedana(id, kaj, od, od + ROK);
    }

    function _porabi(bytes32 id, string memory kaj) internal {
        uint256 od = izvedljivoOd[id];
        require(od != 0, "Ni napovedano");
        require(block.timestamp >= od, "Zamik se ni potekel");
        require(block.timestamp <= od + ROK, "Napoved je potekla");
        delete izvedljivoOd[id];
        emit SpremembaIzvedena(id, kaj);
    }

    // ── Javno ───────────────────────────────────────────────────────────────

    /// @notice Preklic napovedane spremembe. Takojsen — premisliti se mora biti
    ///         mogoce hitreje, kot se izvede.
    function prekliciSpremembo(bytes32 id, string calldata kaj) external onlyOwner {
        require(izvedljivoOd[id] != 0, "Ni napovedano");
        delete izvedljivoOd[id];
        emit SpremembaPreklicana(id, kaj);
    }

    /// @notice Stanje napovedi — da ga stran in nadzorni sistem lahko prikazeta.
    function stanjeNapovedi(bytes32 id)
        external
        view
        returns (bool napovedana, uint256 od, uint256 potece, bool izvedljivaZdaj)
    {
        uint256 t = izvedljivoOd[id];
        if (t == 0) return (false, 0, 0, false);
        return (true, t, t + ROK, block.timestamp >= t && block.timestamp <= t + ROK);
    }
}
          

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.5.0) (token/ERC20/ERC20.sol)

pragma solidity ^0.8.20;

import {IERC20} from "./IERC20.sol";
import {IERC20Metadata} from "./extensions/IERC20Metadata.sol";
import {Context} from "../../utils/Context.sol";
import {IERC20Errors} from "../../interfaces/draft-IERC6093.sol";

/**
 * @dev Implementation of the {IERC20} interface.
 *
 * This implementation is agnostic to the way tokens are created. This means
 * that a supply mechanism has to be added in a derived contract using {_mint}.
 *
 * TIP: For a detailed writeup see our guide
 * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
 * to implement supply mechanisms].
 *
 * The default value of {decimals} is 18. To change this, you should override
 * this function so it returns a different value.
 *
 * We have followed general OpenZeppelin Contracts guidelines: functions revert
 * instead returning `false` on failure. This behavior is nonetheless
 * conventional and does not conflict with the expectations of ERC-20
 * applications.
 */
abstract contract ERC20 is Context, IERC20, IERC20Metadata, IERC20Errors {
    mapping(address account => uint256) private _balances;

    mapping(address account => mapping(address spender => uint256)) private _allowances;

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

    /**
     * @dev Sets the values for {name} and {symbol}.
     *
     * Both values are immutable: they can only be set once during construction.
     */
    constructor(string memory name_, string memory symbol_) {
        _name = name_;
        _symbol = symbol_;
    }

    /**
     * @dev Returns the name of the token.
     */
    function name() public view virtual returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual returns (string memory) {
        return _symbol;
    }

    /**
     * @dev Returns the number of decimals used to get its user representation.
     * For example, if `decimals` equals `2`, a balance of `505` tokens should
     * be displayed to a user as `5.05` (`505 / 10 ** 2`).
     *
     * Tokens usually opt for a value of 18, imitating the relationship between
     * Ether and Wei. This is the default value returned by this function, unless
     * it's overridden.
     *
     * NOTE: This information is only used for _display_ purposes: it in
     * no way affects any of the arithmetic of the contract, including
     * {IERC20-balanceOf} and {IERC20-transfer}.
     */
    function decimals() public view virtual returns (uint8) {
        return 18;
    }

    /// @inheritdoc IERC20
    function totalSupply() public view virtual returns (uint256) {
        return _totalSupply;
    }

    /// @inheritdoc IERC20
    function balanceOf(address account) public view virtual returns (uint256) {
        return _balances[account];
    }

    /**
     * @dev See {IERC20-transfer}.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - the caller must have a balance of at least `value`.
     */
    function transfer(address to, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _transfer(owner, to, value);
        return true;
    }

    /// @inheritdoc IERC20
    function allowance(address owner, address spender) public view virtual returns (uint256) {
        return _allowances[owner][spender];
    }

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on
     * `transferFrom`. This is semantically equivalent to an infinite approval.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function approve(address spender, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, value);
        return true;
    }

    /**
     * @dev See {IERC20-transferFrom}.
     *
     * Skips emitting an {Approval} event indicating an allowance update. This is not
     * required by the ERC. See {xref-ERC20-_approve-address-address-uint256-bool-}[_approve].
     *
     * NOTE: Does not update the allowance if the current allowance
     * is the maximum `uint256`.
     *
     * Requirements:
     *
     * - `from` and `to` cannot be the zero address.
     * - `from` must have a balance of at least `value`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `value`.
     */
    function transferFrom(address from, address to, uint256 value) public virtual returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, value);
        _transfer(from, to, value);
        return true;
    }

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to`.
     *
     * This internal function is equivalent to {transfer}, and can be used to
     * e.g. implement automatic token fees, slashing mechanisms, etc.
     *
     * Emits a {Transfer} event.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _transfer(address from, address to, uint256 value) internal {
        if (from == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        if (to == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(from, to, value);
    }

    /**
     * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from`
     * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding
     * this function.
     *
     * Emits a {Transfer} event.
     */
    function _update(address from, address to, uint256 value) internal virtual {
        if (from == address(0)) {
            // Overflow check required: The rest of the code assumes that totalSupply never overflows
            _totalSupply += value;
        } else {
            uint256 fromBalance = _balances[from];
            if (fromBalance < value) {
                revert ERC20InsufficientBalance(from, fromBalance, value);
            }
            unchecked {
                // Overflow not possible: value <= fromBalance <= totalSupply.
                _balances[from] = fromBalance - value;
            }
        }

        if (to == address(0)) {
            unchecked {
                // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply.
                _totalSupply -= value;
            }
        } else {
            unchecked {
                // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256.
                _balances[to] += value;
            }
        }

        emit Transfer(from, to, value);
    }

    /**
     * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0).
     * Relies on the `_update` mechanism
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _mint(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(address(0), account, value);
    }

    /**
     * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply.
     * Relies on the `_update` mechanism.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead
     */
    function _burn(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        _update(account, address(0), value);
    }

    /**
     * @dev Sets `value` as the allowance of `spender` over the `owner`'s tokens.
     *
     * This internal function is equivalent to `approve`, and can be used to
     * e.g. set automatic allowances for certain subsystems, etc.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `owner` cannot be the zero address.
     * - `spender` cannot be the zero address.
     *
     * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
     */
    function _approve(address owner, address spender, uint256 value) internal {
        _approve(owner, spender, value, true);
    }

    /**
     * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event.
     *
     * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by
     * `_spendAllowance` during the `transferFrom` operation sets the flag to false. This saves gas by not emitting any
     * `Approval` event during `transferFrom` operations.
     *
     * Anyone who wishes to continue emitting `Approval` events on the `transferFrom` operation can force the flag to
     * true using the following override:
     *
     * ```solidity
     * function _approve(address owner, address spender, uint256 value, bool) internal virtual override {
     *     super._approve(owner, spender, value, true);
     * }
     * ```
     *
     * Requirements are the same as {_approve}.
     */
    function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual {
        if (owner == address(0)) {
            revert ERC20InvalidApprover(address(0));
        }
        if (spender == address(0)) {
            revert ERC20InvalidSpender(address(0));
        }
        _allowances[owner][spender] = value;
        if (emitEvent) {
            emit Approval(owner, spender, value);
        }
    }

    /**
     * @dev Updates `owner`'s allowance for `spender` based on spent `value`.
     *
     * Does not update the allowance value in case of infinite allowance.
     * Revert if not enough allowance is available.
     *
     * Does not emit an {Approval} event.
     */
    function _spendAllowance(address owner, address spender, uint256 value) internal virtual {
        uint256 currentAllowance = allowance(owner, spender);
        if (currentAllowance < type(uint256).max) {
            if (currentAllowance < value) {
                revert ERC20InsufficientAllowance(spender, currentAllowance, value);
            }
            unchecked {
                _approve(owner, spender, currentAllowance - value, false);
            }
        }
    }
}
          

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity >=0.6.2;

import {IERC20} from "../IERC20.sol";

/**
 * @dev Interface for the optional metadata functions from the ERC-20 standard.
 */
interface IERC20Metadata is IERC20 {
    /**
     * @dev Returns the name of the token.
     */
    function name() external view returns (string memory);

    /**
     * @dev Returns the symbol of the token.
     */
    function symbol() external view returns (string memory);

    /**
     * @dev Returns the decimals places of the token.
     */
    function decimals() external view returns (uint8);
}