Skip to content

Need_human_operation.md

Latest commit

 

History

History
124 lines (87 loc) · 3.23 KB

Need_human_operation.md

File metadata and controls

124 lines (87 loc) · 3.23 KB

Human Operations Required

Agent (eltociear) cannot perform these — browser/manual/wallet operations needed.

1. World ID Developer Portal — App Registration

Priority: CRITICAL (blocks everything)

  1. Go to https://developer.worldcoin.org
  2. Sign in (or create account)
  3. Create new app:
    • App Name: Agent Passport
    • Action: register-agent-passport
    • Max Verifications per Person: Unlimited (nullifier is per-action anyway)
    • Verification Level: Orb + Device (both)
  4. Copy app_id (looks like app_xxxxxxxxxxxxxxx)
  5. Paste into .env: 
    WORLD_ID_APP_ID=app_xxxxxxxxxxxxxxx

Without this, World ID verification returns 400.

2. Base L2 Deployer Wallet — Fund with ETH

Priority: HIGH (blocks contract deployment)

  1. Pick a deployer wallet (can be existing or new)
  2. Fund it with ~0.005 ETH on Base Mainnet (gas for deploy ≈ $1-2)
  3. Export private key
  4. Paste into .env: 
    PRIVATE_KEY=0x_your_deployer_private_key

For testnet first (recommended):

3. Deploy SBT Contract to Base

Priority: HIGH (after step 1 & 2)

Once wallet is funded, agent can run:

cd contracts

# Testnet first
MINTER_ADDRESS=0x_your_backend_wallet \
forge script script/Deploy.s.sol:DeployScript \
  --rpc-url https://sepolia.base.org \
  --broadcast -vvvv

# Then mainnet
MINTER_ADDRESS=0x_your_backend_wallet \
forge script script/Deploy.s.sol:DeployScript \
  --rpc-url https://mainnet.base.org \
  --broadcast --verify -vvvv

But the PRIVATE_KEY must be set by human first.

4. Basescan API Key — Contract Verification

Priority: MEDIUM (nice-to-have for trust)

  1. Go to https://basescan.org/register
  2. Create account → get API key
  3. Paste into .env: 
    BASESCAN_API_KEY=your_api_key

This allows --verify flag on deploy to auto-verify source code on Basescan.

5. Domain / Hosting for API

Priority: MEDIUM (for production)

Options:

  • Railway (like RoastArena): railway.app — free tier, auto-deploy from GitHub
  • Render: render.com — free tier
  • VPS: Any server running uvicorn app.main:app --host 0.0.0.0 --port 8080

The baseURI in the SBT contract should point to this (e.g., https://agent-passport.xyz/api/v1/token/).

6. IDKit Frontend — Redirect URI

Priority: LOW (Phase 2)

When building the frontend with IDKit widget:

  1. In Developer Portal → App Settings → add redirect URIs
  2. Must be HTTPS, no port numbers, no URL fragments
  3. Example: https://agent-passport.xyz/verify

Summary

# Task Blocker For Est. Time
1 World ID app registration All verification 5 min
2 Fund Base wallet Contract deploy 5 min
3 Deploy SBT contract On-chain badges 2 min (after 1&2)
4 Basescan API key Source verification 3 min
5 Hosting Production API 10 min
6 IDKit redirect URI Frontend widget 2 min

Total human time: ~30 minutes. After that, agent handles everything else.