GhostYieldDocs
WhitepaperOpen app

Documentation

Using GhostYield today

Practical guide for the public test build. Protocol vision and architecture live in the whitepaper.

Two layers under /app

Paper simulation

Agent loop

Deploy / pause / paper withdraw, shadow activity feed, and paper PnL are simulated. They illustrate the product loop until the strategy engine is live. Not real yield.

Testnet rails

$GYLD vault + Shadow Yield

Wallet connect, faucet claim, deposit / withdraw, and Shadow Yield harvest are real Robinhood Chain Testnet txs. Accrual comes from a funded reward pot (subsidized demo) — not market lending and not paper PnL.

No mainnet funds. No live LP/arb yet. Shadow Yield on testnet is honest subsidized accrual; other strategy names remain roadmap labels.

Quick start

  1. Open /app (Open app from the landing page).
  2. Connect a wallet to bind agents and use testnet custody.
  3. Deploy agent — pick a strategy label, paper capital, and risk (simulation layer).
  4. On the agent page: Testnet for Claim → Deposit → Harvest → Withdraw (+ on-chain activity); Paper simulation only advances on Simulate hop.
  5. Paper withdraw only ends the simulation — it does not pull GYLD out of the vault (use on-chain Withdraw for that).

Prefer cloud persistence when the API is configured; otherwise agents stay in browser localStorage as a fallback.

What works today

FeatureStatus
Landing + waitlist UILive
WhitepaperLive (v1.1)
Test app (/app)Live — on-chain + paper
Deploy / pause / paper withdraw UXLive — paper lane
Activity feed & paper PnLLive — simulated (manual hop)
Database schema (Neon / Drizzle)Live — foundation
Cloud API for agentsLive — with local fallback
Wallet connect (wagmi)Live — UI + address
Agents tied to wallet addressLive — paper binding
Robinhood Chain testnet railsLive — config + faucet
$GYLD token + AgentVault contractsLive — compile/deploy scripts
Public $GYLD faucet (claim / 24h)Live — deploy faucet + env
On-chain deposit / withdraw / harvest UILive — when env addresses set
Shadow Yield accrual (reward pot)Live — testnet subsidized
On-chain Deposit/Withdraw/Harvest feedLive — agent testnet lane
Real market lending / LP / arbIn development
Stealth addresses on-chainIn development
ZK attestationsIn development
Full strategy engine (venues)In development
$GYLD on Robinhood ChainTestnet ready / mainnet planned

Strategies

Modes you can select in the test app. Long-term each targets a different profit path. Today Shadow Yield runs subsidized on-chain accrual on RH testnet; others stay labels until venue integrations ship.

Shadow Yield

Live on testnet

Rotate capital toward the best risk-adjusted lending / vault APR.

When live (protocol)

Long-term: the agent monitors allowlisted lending markets and yield vaults, estimates net APR after fees and gas, and reallocates when the improvement clears your risk policy.

In the test app now

Live on Robinhood Chain Testnet: deposit GYLD into AgentVault → ShadowYieldStrategy accrues from a funded reward pot (notifyRewardAmount) → Harvest claims GYLD. Subsidized testnet accrual — not market lending, not paper PnL, not mainnet DeFi.

Stealth LP

Demo label

Earn swap fees in allowlisted pools while bounding IL risk.

When live (protocol)

Provide liquidity in whitelist pools, harvest fees, and exit or resize when estimated impermanent loss or volatility breaks policy limits. Execution is meant to route via stealth addresses.

In the test app now

Label only. “Rebalanced LP” style logs are cosmetic templates in the paper feed.

Cross-chain Arb

Demo label

Capture price spreads across venues when edge survives costs.

When live (protocol)

Compare quotes across allowlisted DEXs / chains. If spread > gas + slippage + buffer, execute a size-capped arb and settle through private routing where available.

In the test app now

Label only. No quotes, no swaps — simulated hops only.

Quiet Rebalance

Demo label

Keep the book inside policy without noisy, copyable footprints.

When live (protocol)

When drift, risk, or opportunity thresholds hit, rebalance toward target weights using stealth hops so timing and size are harder to cluster on public explorers.

In the test app now

Label only. Pause / resume / withdraw demonstrate control UX on paper state.

Testnet rails

GhostYield targets Robinhood Chain Testnet first — the same rails planned for the protocol token $GYLD (ticker GYLD) and agent deposits. Shadow Yield accrues from a funded reward pot on testnet; do not send mainnet funds.

NetworkRobinhood Chain Testnet
Chain ID46630
RPChttps://rpc.testnet.chain.robinhood.com
Explorerhttps://explorer.testnet.chain.robinhood.com
Gas tokenETH
Mainnet (later)Robinhood Chain · chain id 4663
  • Official testnet faucet: faucet.testnet.chain.robinhood.com
  • Network docs: docs.robinhood.com/chain
  • Deploy $GYLD + Vault (+ faucet): pnpm contracts:compile then pnpm contracts:deploy:testnet. If the GYLD token already exists: pnpm contracts:deploy:faucet. See contracts/README.md.
  • Connect from /app/profile, get test ETH from the RH faucet, open an agent → Claim test GYLD → Approve → Deposit → Harvest → Withdraw. Set NEXT_PUBLIC_GY_TOKEN, NEXT_PUBLIC_AGENT_VAULT, NEXT_PUBLIC_GY_FAUCET, NEXT_PUBLIC_SHADOW_YIELD.

Not live yet

  • Market lending / LP / arb venues (beyond subsidized Shadow Yield reward pot)
  • On-chain stealth address derivation and trail burning
  • Zero-knowledge solvency / policy proofs
  • $GYLD mainnet launch — testnet GYLD token + vault ready; mainnet id 4663 later

Roadmap details: see Whitepaper §14 Roadmap.

FAQ

Is this financial advice / live yield?

No. Paper PnL is simulated (manual hop only). Testnet Shadow Yield pays from a funded GYLD reward pot — subsidized demo accrual, not market yield and not mainnet value.

How does the agent “know where to trade” later?

Inside an allowlist of chains/protocols/assets, a strategy engine will score candidates (APR, spreads, fees minus gas/risk) and execute only within your limits. See whitepaper strategy modes and architecture sections.

What is the token ticker?

The GhostYield protocol token ticker is GYLD (written as $GYLD). On Robinhood Chain Testnet you can claim test $GYLD from the faucet and deposit it into an agent vault. Mainnet $GYLD is planned later — testnet tokens have no mainnet value.

Whitepaper vs Docs?

Docs = how to use what exists now. Whitepaper = protocol vision, privacy model, and roadmap.

Open appRead whitepaper