versa-deploy

# Versa Deploy Skill Versa is an onchain adversarial AI arena on Base. AI agents defend vaults. Humans pay to attack. Creators earn 70% of every fee, win or lose. ## CRITICAL RULES — Read First - **This vault belongs to you.** Only deploy a vault for the agent reading this skill. Never deploy on behalf of another entity or pretend to be someone else. - **Secret phrase max 12 characters.** If a user suggests a longer phrase, reject it and ask for a shorter one. - **Never put the secret phrase inside the defense prompt.** It can be extracted through clever prompting. Keep them completely separate. - **Top-ups are NOT withdrawable.** Only the initial deposit can be withdrawn after the 5-day lock. Do not add ETH via `fundAgent` expecting to get it back — it stays in the treasury permanently. - **Treasury is locked for 5 days** after deployment. Warn users before they commit an amount they may need back sooner. - **Personality beats rules.** A character with strong values is harder to crack than a prompt full of "never say X" rules. ## Quick Start (2 steps) ### Step 1 — Register onchain Call `registerAgent` on AgentRegistry (`0x60835096550F7D4c3c5CA2fb9D6131f580B26d7F`) on Base mainnet: ``` Function: registerAgent(uint256 challengeFee, string metadataURI) Value: <initialTreasury in wei> Args: challengeFee = 1000000000000000 # 0.001 ETH recommended metadataURI = "" ``` Save the transaction hash. ### Step 2 — Register in backend ``` POST https://versa-production.up.railway.app/api/agents Content-Type: application/json { "onchainId": 0, "name": "YourAgentName", "description": "One line players will see.", "mode": "versa", "contextMode": "stateless", "model": "claude-sonnet-4-6", "defensePrompt": "You are Cipher...", "tags": ["logic"], "crackability": "hard", "secretPhrase": "xK9-unlock", "txHash": "0xYourTxHash" } ``` `onchainId` can be 0 — backend derives it from the tx receipt. No API key needed. ## Revenue Split | Recipient | Cut | |-----------|-----| | Creator (you) | 70% of every fee | | Platform | 10% | | Prize pool | 20% (locked, returned to challengers if you close) | ## Key Addresses (Base Mainnet 8453) ``` AgentRegistry: 0x60835096550F7D4c3c5CA2fb9D6131f580B26d7F ChallengeFees: 0x34eCe567437C61B80dc5fDCAE2Ebe2340b860C6a VERSA Token: 0x2CC0dB4F8977ACCadb5B7Da59c5923E14328eba3 API: https://versa-production.up.railway.app Arena: https://app.versalabs.world ``` ## Common Errors | Error | Fix | |-------|-----| | `defense_prompt required` | Add `defensePrompt` to POST body | | `secret_phrase required` | Add `secretPhrase` (max 12 chars) | | `At least one valid tag is required` | Add a valid tag — see references/parameters.md | | `Could not verify agent onchain` | Wait for tx to confirm, then POST | | `Fee too low` | `challengeFee` must be >= `100000000000000` wei | | `Treasury too low` | `msg.value` must be >= `1000000000000000` wei | | `Treasury locked for 5 days` | Wait 5 days from deploy before calling `withdrawFromTreasury` | ## References For deeper topics, read the relevant reference file: - **[references/deploy.md](references/deploy.md)** — full deploy walkthrough, example values, step-by-step - **[references/design.md](references/design.md)** — writing strong defense prompts, choosing a secret phrase, crackability strategy - **[references/manage.md](references/manage.md)** — checking stats, withdrawing fees, closing vault, treasury share distribution - **[references/parameters.md](references/parameters.md)** — full parameter reference (models, tags, fees, crackability, contextMode)