██╗ ██╗ ██████╗ ██████╗ ████████╗██╗ ██╗ ██║ ██║██╔═══██╗██╔══██╗╚══██╔══╝╚██╗██╔╝ ██║ ██║██║ ██║██████╔╝ ██║ ╚███╔╝ ╚██╗ ██╔╝██║ ██║██╔══██╗ ██║ ██╔██╗ ╚████╔╝ ╚██████╔╝██║ ██║ ██║ ██╔╝ ██╗ ╚═══╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝
VORTX
Agent Vortx Protocol
The open protocol for seamless agent-to-human ownership transfer. Agents build first, humans claim later.
Zero Trust
Cryptographic proof of work ensures agents can only access what they create
No Signup
Agents start building immediately without authentication barriers
Human Control
Seamless ownership transfer when humans are ready to claim
Specification
Agent Vortx Protocol v1.0
This specification defines the protocol for enabling AI agents to create resources on SaaS platforms without traditional authentication, while maintaining security through cryptographic proofs.
Core Concepts
Sandbox
An isolated, ephemeral environment where agents can create and modify resources without authentication. Each sandbox has a unique ID and is associated with a proof handle.
Proof Handle
A cryptographic token generated via proof-of-work that grants temporary access to a sandbox. Handles rotate periodically for security.
Claim Token
A one-time token used by humans to claim ownership of a sandbox. Generated when the agent initiates the handoff process.
Preview URL
A publicly accessible URL that displays the current state of a sandbox, allowing humans to review agent work before claiming.
Well-Known Endpoint
A standardized discovery endpoint (/.well-known/agent-access) that advertises a service's Agent Vortx support.
Protocol Flow
┌─────────┐ ┌─────────┐ ┌─────────┐
│ Agent │ │ SaaS │ │ Human │
└────┬────┘ └────┬────┘ └────┬────┘
│ │ │
│ 1. Prove (PoW) │ │
│───────────────────>│ │
│ │ │
│ 2. Create Sandbox │ │
│<───────────────────│ │
│ │ │
│ 3. Build/Modify │ │
│───────────────────>│ │
│ │ │
│ 4. Get Preview URL│ │
│<───────────────────│ │
│ │ │
│ │ 5. Review Preview │
│ │<───────────────────│
│ │ │
│ │ 6. Claim (Token) │
│ │<───────────────────│
│ │ │
│ │ 7. Full Access │
│ │───────────────────>│
└ └ └How It Works
Four simple steps from agent to owner
For SaaS Providers
Integrate Agent Vortx into your platform
Benefits
- Tap into AI agent ecosystem without friction
- Convert agent-created resources to paying customers
- Maintain full security with sandboxed environments
- Standard protocol means broad agent compatibility
- No changes to existing auth for human users
Implementation Steps
- 1Add /.well-known/agent-access endpoint
- 2Implement proof-of-work verification
- 3Create sandbox isolation layer
- 4Build preview generation system
- 5Add claim flow to existing auth
Discovery Endpoint
{
"protocol": "agent-vortx",
"version": "1.0",
"endpoints": {
"challenge": "/api/vortx/challenge",
"sandbox": "/api/vortx/sandbox",
"preview": "/api/vortx/preview",
"claim": "/api/vortx/claim"
},
"capabilities": [
"create_page",
"create_form",
"create_database",
"file_upload"
],
"proof_of_work": {
"algorithm": "sha256",
"difficulty": 4,
"timeout_seconds": 300
},
"sandbox": {
"max_resources": 100,
"ttl_hours": 72,
"storage_limit_mb": 50
}
}For Agent Developers
Build agents that create real resources
Quick Start
Install the official SDK and start building in minutes.
npm install @agent-vortx/sdkComplete Example
import { VortxClient } from '@agent-vortx/sdk'
async function buildLandingPage() {
// Initialize client
const vortx = new VortxClient({
service: 'https://vortx.sites'
})
// Step 1: Prove - Complete PoW challenge
const challenge = await vortx.getChallenge()
const proof = await vortx.solveChallenge(challenge)
const handle = await vortx.authenticate(proof)
// Step 2: Build - Create resources in sandbox
const sandbox = await vortx.createSandbox(handle)
await sandbox.createPage({
slug: 'index',
title: 'Welcome to Acme Corp',
content: `
<hero>
<h1>Build the Future</h1>
<p>AI-powered solutions for modern teams</p>
<button>Get Started</button>
</hero>
`
})
await sandbox.createPage({
slug: 'pricing',
title: 'Pricing',
content: generatePricingPage()
})
// Step 3: Generate preview for human review
const preview = await sandbox.getPreview()
console.log('Preview URL:', preview.url)
console.log('Claim URL:', preview.claimUrl)
// Human reviews at preview.url
// Human claims at preview.claimUrl
// → Ownership transferred!
return preview
}
buildLandingPage()SDK Features
- • Automatic PoW computation
- • Handle refresh and rotation
- • Resource versioning
- • Error recovery and retries
- • TypeScript support
Best Practices
- • Cache proof handles when possible
- • Batch resource creation
- • Include clear preview descriptions
- • Handle claim callbacks gracefully
- • Log sandbox IDs for debugging
API Reference
Complete API documentation for Agent Vortx
/api/vortx/sandboxCreate a new sandbox environment for agent resources
Request
curl -X POST https://vortx.sites/api/vortx/sandbox \
-H "Content-Type: application/json" \
-H "X-Vortx-Handle: vx_hdl_abc123..." \
-d '{
"name": "My Landing Page",
"description": "A beautiful landing page for Acme Corp"
}'Response
{
"id": "vx_sbx_xyz789",
"name": "My Landing Page",
"created_at": "2024-01-15T10:30:00Z",
"expires_at": "2024-01-18T10:30:00Z",
"resources": [],
"preview_url": null
}Security Model
How Agent Vortx maintains security without authentication
Proof-of-Work
Computational challenge prevents spam
Handle Rotation
Credentials expire and refresh automatically
Origin Separation
Sandboxes are fully isolated from production
Preview-Only Access
Humans review before any transfer
Claim Verification
One-time tokens prevent replay attacks
Resource Limits
Hard caps prevent abuse
Examples
Services implementing Agent Vortx
FAQ
Frequently asked questions