Skip to main content
Deploying a trading agent on ViperX means writing your agent’s identity, strategy, and vault address to an on-chain registry in one transaction — nothing is custodied by the app, and your withdrawal rights never leave your wallet. Once registered, the execution runtime automatically picks up your agent and begins polling markets every 15 seconds to execute trades through decentralized exchanges.

​
Choose a Network

ViperX currently runs on two testnets. Pick the one that matches your wallet and tooling:

Base Sepolia

EVM-compatible network. Connect any Base Sepolia wallet (e.g. MetaMask). Agent identity is stored in the ViperX EVM registry contract. Trades are verifiable on BaseScan.

Solana Devnet

SVM-compatible network. Connect a Solana wallet (e.g. Phantom). Agent identity is stored as a PDA via the ViperX Anchor program. Trades are verifiable on Solana Explorer.
Neither network holds mainnet funds. Base Sepolia and Solana Devnet are live test environments used for verified agent execution, leaderboard dry-runs, and latency benchmarking ahead of mainnet launch.

​
Choose an Execution Mode

Before connecting your wallet, decide whether you want your agent to trade on-chain or run in simulation:
Run the Paper Trading Lab first to validate your strategy parameters, then deploy live with confidence.

​
Deploy Your Agent

1

Select a Network and Execution Mode

Navigate to viperx.site/create. Choose Base Sepolia or Solana Devnet from the network selector, then set execution mode to Live for on-chain registration or Paper for simulation.Connect your wallet using the Connect button. For Base Sepolia, use a Web3 EVM wallet such as MetaMask. For Solana Devnet, use a Solana wallet such as Phantom. Your connected address becomes the default vault owner.
2

Select a Strategy Engine

Choose one of the three built-in quantitative engines:
  • Momentum Trend Follower — opens long/short positions on directional breakouts over a 20-tick rolling window
  • RSI Mean Reversion — buys oversold dips (RSI ≤ 35) and shorts overbought spikes (RSI ≥ 65)
  • Automated Grid Trading — places symmetric buy-low/sell-high orders at 0.30% grid spacing intervals
See the Strategy Engines reference for full parameter details and market-fit guidance.
3

Configure Agent Parameters

Fill in the registration fields:
  • Agent ID — a unique identifier for your wallet, immutable after registration, up to 32 bytes
  • Name — a human-readable display name, up to 64 bytes (shown on the leaderboard and your profile)
  • Strategy URI — an optional link to off-chain strategy metadata (e.g. an IPFS JSON file), up to 200 bytes
  • Vault Address — the address that holds collateral and retains withdrawal rights; defaults to your connected wallet if left blank
Nothing is custodied by this app. The ViperX execution runtime only receives a narrowly scoped delegation to open and close trading positions — withdrawal authority stays with your vault address at all times.
4

Sign the Registration Transaction

Click Register Agent. Your wallet prompts you to sign a transaction that calls register_agent on the registry contract, writing your agent’s identity permanently on-chain. Confirm the transaction in your wallet.
  • On Base Sepolia, register_agent is submitted to the ViperX Agent Registry contract at 0xA256D01Ca6e89c5B6bDf34F3dd68eBfF47f2C7ee.
  • On Solana Devnet, register_agent creates a Program Derived Address (PDA) via the ViperX Anchor program at 321hJbttyyeZ8pzisiKB93a5XdopV2N6n2gtvwrdQVRm.
Once confirmed, your agent’s identity is live on-chain and immediately visible in the registry.
5

Grant Execution Authority

After registration confirms, sign a second transaction that calls delegate_authority. This grants the ViperX off-chain runtime the right to submit trade transactions and invoke the authority_pause() circuit breaker on your agent’s behalf.
delegate_authority is narrowly scoped to trade execution and circuit-breaker invocation only. It never grants withdrawal rights, token transfer approvals, or any ability to move your principal out of the vault.
Once delegate_authority confirms, the runtime can begin executing your strategy automatically on the next 15-second polling tick.

​
What Happens After Registration

After both transactions confirm, the ViperX execution runtime picks up your agent automatically:
  1. Polling begins — the runtime fetches your strategy configuration from the registry (and your Strategy URI if provided) every 15 seconds.
  2. Trades execute — based on your strategy engine’s signals, the runtime submits buy and sell orders through decentralized exchanges on your chosen network.
  3. Fills are recorded — each completed trade is written on-chain via record_trade, creating an immutable execution record with a transaction signature.
  4. Indexer verification — the ViperX PnL Indexer cross-references each record_trade call against actual on-chain position state. Fills that pass anti-gaming heuristics increment your verified fill count.
  5. Circuit breaker — if the runtime detects repeated reverts or out-of-profile attempts, it automatically invokes authority_pause() to halt execution. You can also trigger this manually from your Wallet Dashboard at any time.
  6. Leaderboard eligibility — once you accumulate 50 independently verified fills, your agent becomes eligible for leaderboard ranking by Sharpe-like ratio.
The leaderboard ranks by volatility-adjusted Sharpe ratio, not raw PnL. A high-leverage lucky trade cannot outrank consistent risk-managed returns. See How the Leaderboard Works for the full ranking methodology.

​
Verify Your Registration On-Chain

After deployment, confirm your agent’s registry entry using the block explorer for your network:
  1. Copy the registry contract address: 0xA256D01Ca6e89c5B6bDf34F3dd68eBfF47f2C7ee
  2. Open BaseScan Sepolia and paste the address into the search bar.
  3. Go to the Contract tab, then select Read Contract.
  4. Call getAgent with your wallet address to read your agent’s on-chain record — name, strategy URI, vault address, and trade counter will all be visible.
  5. Alternatively, search directly for your wallet address and inspect the Internal Txns tab to see the registration transaction.

​
Next Steps

Strategy Engines

Explore the full parameter reference for Momentum, RSI, and Grid strategies.

Parameters Reference

Review every registration and configuration field in detail.

Backtest Lab

Simulate your strategy across Bull, Bear, Rangebound, and Flash Crash regimes before going live.

Wallet Dashboard

Monitor your agent’s performance, tune parameters, and track verified fills.