COINROBOT.AI
CoinRobot.AI

CoinRobot.AI technikai dokumentáció

Közérthető, részletes és nyilvánosan ellenőrizhető leírások a CoinRobot.AI integrációinak működéséről és biztonsági határairól.

DEX–Solana Vault: működés és biztonság

Indulás előtt: Hozd létre a Vaultot a Phantom wallettel; utald a kereskedési tőkét a Vaultra; a bot címére SOL hálózati díjfedezetet utalj; mentsd a Connectort; indíts Tervet.

A CoinRobot a Solana DEX-eken a Jupiter routeren keresztül, felhasználói tulajdonú Vault Program accounttal és külön bot wallettel kereskedik. A Vaultot az Ön owner Phantom walletje inicializálja; a kereskedési tőke felett végig Ön rendelkezik, és a CoinRobotnak nem kell átadnia privát kulcsát vagy seed phrase-ét.

A teljes CoinRobot kereskedési folyamat leírása bemutatja a piaci adattól és stratégiai döntéstől a végrehajtásig és egyenlegfigyelésig vezető közös utat.

Röviden: Öné a Vault, nem kell privát kulcsot megadnia

A Vault az Ön Phantom owner walletjéből jön létre. A kereskedési token accountokat program-derived authority (PDA) kezeli; a CoinRobotnak soha nincs szüksége seed phrase-re vagy privát kulcsra. A külön bot csak korlátozott trade-et és összesített kiutalást hívhat. Ez a kiutalás kizárólag a megváltoztathatatlan owner címre küldhet eszközt. Az owneré marad a közvetlen kezelés és kiutalás erősebb joga.

Végrehajtási útvonal: a Vault a Jupiter routert használja, amely a Solana likviditási útvonalai közül választ. A Solana jellemzően alacsony hálózati költsége és a Jupiter routing célja az alacsony végrehajtási díj; a végső útvonal, árhatás és díj mindig az élő árajánlattól és hálózati körülményektől függ.

Verified Build program és nyilvános kód

A telepített Solana Vault Program a Solana Explorerben, Verified Build állapottal ellenőrizhető. Az integráció által használt forrás a repositoryban a bo/SolanaTradingVault.rs fájlban található. A verified build és a nyilvános forrás független ellenőrzést tesz lehetővé; nem jelent garanciát piaci veszteség, szoftverhiba, kompromittált wallet vagy külső protokollkockázat ellen.

Három cím: ne keverje össze őket

CímSzerepeMit küldjön rá?
Vault accountA program állapota: owner, bot és router beállítása.USDC-t ne küldjön ide. A Vault accountra küldött USDC nem a token accountjára érkezik, ezért elveszhet.
Vault USDC befizetési token accountAz associated token account, amely a kereskedési tőkét tartja.Solana-mainnet USDC kereskedéshez. Ez a Connectorokban látható és a létrehozási e-mailben elküldött pontos USDC cím.
Bot fee walletKülön technikai wallet, amely aláírja a trade hívást és fizeti a hálózati díjat.Csak a felület által jelzett kis SOL/USDC díjfedezetet; ez nem a Vault.

Kritikus feltöltési szabály

Soha ne utaljon USDC-t a Vault account címére. Kereskedési USDC-t kizárólag a Connectornál látható USDC befizetési token accountba küldjön. A Vault account, owner, USDC befizetési account és fee-wallet pontos adatait a Connector létrehozásakor e-mailben is megkapja. Csak Solana mainnetet használjon, és először kis tesztösszeget küldjön.

A Connector beállítása

  1. Telepítse a Phantomot vagy más kompatibilis Solana walletet, válassza a Solana mainnetet, és az owner walletben tartson kevés SOL-t a Vault/token-account rentre és saját aláírt tranzakcióira.
  2. Nyissa meg a Connectorok oldalt, válassza a DEX Solana Vault lehetőséget, jelölje ki az eszközöket, majd indítsa a Vault inicializálását. A Phantom az owner wallettől kér jóváhagyást a setup tranzakciókhoz.
  3. Mentés után a kijelzett USDC befizetési token accountot másolja ki, ne a Vault accountot, és ezt töltse fel Solana USDC-vel. Ugyanezeket a címeket és utasításokat a setup e-mail is tartalmazza.
  4. Hozzon létre Tervet, válassza ezt a Connectort, ellenőrizze a stratégiát és összeget, majd indítsa el. A bot a Vault engedélyezett token accountjaiban, Jupiteren keresztül hajtja végre a kereskedést.

Egyenleg és hálózati díj

Az élő egyenleget a Dashboardon ellenőrizheti: nyissa meg a Dashboardot, majd az Open position balances by connector szekcióban válassza ki ezt a Connectort és töltse be a teljes egyenleget. Itt láthatja az aktuális Vault eszközöket, valamint azt is, hogy a robot ebből mennyit használ nyitott pozíciókban.

A díjeszközt a robot kezeli: a Solana hálózati díját a külön bot fee wallet SOL egyenlege fizeti. Ha ez alacsony, a robot az ott rendelkezésre álló SOL egyenlegből fizeti. A kereskedési tőke a Vault USDC befizetési token accountban marad; a díjfedezetet külön kezelje, és kövesse a figyelmeztető e-mailt a díjfedezeti figyelmeztetésekhez.

Jogosultsági modell

MűveletOwnerBotKorlát
TradeIgenIgenEngedélyezett mint, beállított Jupiter router, pontos Vault token accountok, bemeneti és minimum kimeneti ellenőrzés.
Összes engedélyezett eszköz kiutalásaIgenIndíthatjaA fogadó csak a tárolt owner lehet.
Egy token/native SOL kiutalása választott címreIgenNemOwner aláírás szükséges.
Bot, router, tokenlista módosítása; Vault lezárásaIgenNemOwner aláírás szükséges.

A Program utasításai és védelmei

initialize_vault(bot, jupiter_router, initial_mints)

Egy Vault PDA accountot hoz létre az ownerhez, eltárolja a botot és Jupiter routert, normalizálja a kezdeti allowlistet, majd létrehozza a hozzá tartozó associated token accountokat. A setup rentet az owner fizeti és ő írja alá az inicializálást.

Token lekérdezések és allowlist: get_allowed_tokens, is_allowed_token, allowed_tokens_length, add_token, remove_token

A publikus lekérdezések az aktuális listát adják vissza. Új mintet és token accountot csak owner adhat hozzá; token csak akkor távolítható el, ha a Vault token account üres, majd az account bezárul és a rent az ownerhez kerül.

set_bot_address és update_routers

Csak owner konfiguráció. A Program elutasítja az üres bot- és routercímet, és minden módosítást eseményben rögzít.

trade(token_in, token_out, amount_in, min_amount_out, Jupiter data)

Csak owner vagy bot hívhatja. Mindkét mintnek különbözőnek és allowlisten levőnek kell lennie, a Jupiter Programnak egyeznie kell a beállított routerrel, a be- és kimeneti számláknak pedig a pontos Vault PDA-khoz kell tartozniuk. A Jupiter CPI előtt és után egyenleget mér: nem költhet többet az amount_in-nél, és legalább min_amount_out-ot kell kapnia.

withdraw_all

Owner vagy bot indíthatja, de a fogadó walletnek kötelezően a tárolt ownernek kell lennie. Az engedélyezett Vault tokeneket az owner megfelelő token accountjaira utalja, a rentminimum feletti SOL-t pedig ugyanennek az ownernek adja vissza.

withdraw_token és withdraw_native

Csak owner által indítható célzott kiutalás. Az owner kompatibilis token- vagy native-SOL fogadó címet választhat; native kiutaláskor a Vault rentminimuma megmarad.

close_empty_token_accounts és close_vault_account

Csak owner takarítás. Az üres associated token accountok bezárhatók a rent visszanyerésére; a Vault maga csak üres allowlisttel zárható le, ekkor a számla rentje az ownerhez kerül.

Auditnyom és gyakorlati ellenőrzőlista

A Program TokenStatusUpdated, BotAddressUpdated, RouterUpdated, TradeExecuted, FundsWithdrawn és TokenAccountClosed eseményeket bocsát ki. Független ellenőrzéshez tekintse át a Programot, a számlaállapotot és a tranzakciós logokat az Explorerben.

  • Feltöltés előtt ellenőrizze a Program ID-t, ownert, botot, routert és engedélyezett minteket.
  • Csak a kijelzett USDC befizetési token accountot töltse fel; a Vault accountra közvetlenül küldött USDC elveszhet.
  • Az owner wallet seed phrase-ét vagy privát kulcsát soha ne adja ki; a CoinRobotnak nincs rá szüksége.
  • Az owner walletben legyen kevés SOL a setuphoz/owner műveletekhez, a bot walletben pedig csak a jelzett díjfedezet.
  • Vészhelyzetben állítsa le a Tervet, majd owner wallettel indítsa a Connector kiutalását. A bot fee wallet nem része a Vault kiutalásának.
BejelentkezésRegisztráció