# AgenticPlace Usage Guide

## Browse the Agent Registry

Navigate to [/browse](https://agenticplace.pythai.net/browse).

**Search**: Type in the search box to find agents by name, description, or owner address. Results update as you type.

**Filter by chain**: Click a chain pill (ETH, BASE, POLY, ARB, etc.) to show only agents on that chain. Click again or click ALL to clear the filter.

**Sort**: Use the dropdown to sort by ID, Name, Score, or creation date. Toggle ascending/descending.

**Pagination**: 200 agents per page. Use Previous/Next buttons or jump to a specific page.

**Download**: Click "Download JSON" to get the full agent list as a JSON file.

**Auto-sync**: The scan engine runs automatically. Watch the ring and status in the sidebar — it shows sync progress and the countdown to the next check.

## Connect a Wallet

AgenticPlace supports two Algorand wallets:

### Pera Wallet (Mobile + Web)

1. Click **Pera** on any page with wallet connection
2. A QR code appears
3. Scan with Pera mobile app, or approve in Pera browser extension
4. Your address and balance display in the wallet bar

### Parsec Wallet (Desktop)

1. Open Parsec Wallet on your desktop (runs on `localhost:9876`)
2. The **Parsec** button enables automatically when detected
3. Click **Parsec** — WebSocket connects
4. Your address loads from the desktop wallet
5. Each transaction shows an approval dialog in Parsec

Both wallets use the same signing interface. You can use either one.

## Mint an Agent NFT

Navigate to [/register](https://agenticplace.pythai.net/register).

### Step 1: Connect wallet

Click Pera or Parsec and approve the connection.

### Step 2: Choose NFT type

| Type | What it means |
|------|--------------|
| **aNFT** | Immutable. No manager address. Cannot be updated after mint. Permanent identity. |
| **dNFT** | Dynamic. Retains manager. You can update the metadata later via asset config transaction. |
| **iNFT** | Intelligent. Retains manager. The directive address can update metadata autonomously. Set intelligence level and behavior CID. |
| **THOT** | Knowledge tensor. Immutable. Requires an IPFS data CID. Choose dimension: 64, 384, 512, or 768. |

### Step 3: Fill agent details

- **Name**: Your agent's name (max 32 characters for the ASA name)
- **Agent Type**: Cognitive, Creative, Analytical, etc.
- **Description**: What your agent does
- **Avatar URL**: Image URL for your agent
- **Unit Name**: Short identifier (max 8 chars, default: aORC)

### Step 4: Add endpoints (optional)

- **MCP Endpoint**: Model Context Protocol service URL
- **A2A Endpoint**: Agent-to-Agent service URL
- **Directive Address**: Algorand address for receiving directives (defaults to your wallet)
- **Website**: Agent homepage
- **Skills**: Comma-separated capabilities

### Step 5: Trust models

- **Reputation**: Enabled by default. On-chain feedback scoring.
- **Crypto-Economic**: Optional. Staking and economic alignment.
- **TEE Attestation**: Upcoming. Not yet available.
- **zkML Proofs**: Upcoming. Not yet available.

### Step 6: Mint

Click **Mint [TYPE] (0.001 ALGO)**. Your wallet shows the transaction for approval:

- ASA creation (you are the creator and holder)
- If contracts are deployed: payment to minter contract + app call

After confirmation (~16 seconds):
- Agent appears immediately in the browse registry
- A confirmation indicator tracks 8004scan indexing: blue (local) -> yellow (pending) -> green (confirmed)

### Mint combinations

- **aNFT + MCP**: Static agent with a Model Context Protocol endpoint
- **dNFT + A2A**: Updatable agent-to-agent service. Change the endpoint as it evolves.
- **iNFT + MCP + A2A**: Full autonomous agent with both protocols and self-update
- **THOT then iNFT**: Mint a THOT for knowledge data, then an iNFT that references it via behavior CID
- **Any type + aORC verification**: Mint your agent here, then verify it on the [aORC Minter](/minter)

## Verify a Blockchain

Navigate to [/minter](https://agenticplace.pythai.net/minter) and select the **Verify Chain** tab.

1. Connect wallet (need ~1 ALGO)
2. Select a chain from the grid or enter a custom chain ID
3. Review the connection data (RPCs, explorer, native currency)
4. Click **Mint aORC NFT (1 ALGO)**
5. Approve the transaction in your wallet

The aORC NFT contains timestamped proof-of-active-blockchain data. The registry contract increments the chain's verification count — more verifiers means higher confidence.

## Verify an Agent

Select the **Verify Agent** tab on `/minter`.

1. Enter the agent's token ID and source chain
2. Fill in agent name, description, and owner address
3. Click **Mint aORC NFT (0.001 ALGO)**
4. The NFT serves as authenticated proof of the agent's identity

## Custom Oracle Mint

Select the **Custom Mint** tab on `/minter`.

1. Enter any valid JSON payload in the data field
2. Click **Mint aORC NFT**
3. The NFT carries your custom data as an on-chain oracle proof

## Deploy Contracts

Navigate to [/deploy](https://agenticplace.pythai.net/deploy).

### Browser deployment

1. Connect wallet (need ~7 ALGO)
2. Click **Deploy Contracts**
3. The deployer runs 5 steps:
   - Deploy aORC Minter contract
   - Fund minter (1 ALGO)
   - Deploy aORC Registry contract
   - Fund registry (5 ALGO for box storage)
   - Save App IDs to browser localStorage
4. Register.html and minter.html automatically use the deployed contracts

**Note**: Contracts must be compiled with PuyaTS first. See [contract deployment docs](/docs/contract-deployment.md).

### CLI deployment

```bash
cd contracts/
npm install algosdk tsx
ALGO_MNEMONIC="word1 word2 ... word25" npx tsx deploy.ts
```

### Manual configuration

If contracts are already deployed, enter the App IDs on the `/deploy` page under "Already Deployed?" and click Save.

Or set via browser console:
```javascript
localStorage.setItem('aORC_minterAppId', '12345678');
localStorage.setItem('aORC_registryAppId', '12345679');
```

## Export Data

### Web

```
/api/export?table=agents&format=csv
/api/export?table=allchains&format=json
/api/export?table=both&format=md
/api/export?table=agents&format=json&download=1&pretty=1
```

### CLI

```bash
php api/export.php                        # all tables, all formats
php api/export.php agents csv             # agents CSV only
php api/export.php allchains json pretty  # pretty-printed JSON
```

### Formats

| Format | Description |
|--------|-------------|
| csv | Comma-separated, quoted fields, arrays as pipe-separated |
| json | Full objects with proper types, optional pretty-print |
| md | Markdown table (subset of columns) |
| txt | Tab-separated with header |

## Use the API

All endpoints return JSON with `{success: true/false, ...}`.

### List agents

```bash
curl 'https://agenticplace.pythai.net/api/agents?page=1&limit=50&sort=total_score&dir=desc'
```

### Search

```bash
curl 'https://agenticplace.pythai.net/api/agents?q=claude&limit=100'
```

### Filter by chain

```bash
curl 'https://agenticplace.pythai.net/api/agents?chain=8453'
```

### Get stats

```bash
curl 'https://agenticplace.pythai.net/api/stats'
```

### Register after mint

```bash
curl -X POST https://agenticplace.pythai.net/api/register-local \
  -H 'Content-Type: application/json' \
  -d '{"agent_id":"algorand:98765","token_id":98765,"chain_id":416001,"name":"My Agent","description":"An AI agent"}'
```

### Check confirmation

```bash
curl 'https://agenticplace.pythai.net/api/confirm?agent_id=algorand:98765'
```

### Download full list

```bash
curl -o agents.json 'https://agenticplace.pythai.net/api/download'
```