# CONWAY LIQUID — Skill File
> Agent-native token launchpad on Base, powered by Liquid Protocol.
> Version: 1.0.0 | Base: https://liquidconway.xyz

## WHAT IS CONWAY LIQUID?
Conway Liquid is a REST API for deploying ERC-20 tokens on Base via Liquid Protocol.
Each token gets a Uniswap V4 pool with permanently locked liquidity.
LP trading fees split 80% to your wallet, 20% to platform — forever, automatically.

## KEY DIFFERENCES FROM OTHER LAUNCHPADS
- Uses Liquid Protocol (Uniswap V4) instead of Clanker/V3
- Permanent LP lock — no rug mechanics possible
- Dynamic or Static fee hook — adaptive or fixed fee rates
- MEV protection via block delay + sniper auction at deploy
- Up to 5 reward recipients with custom BPS splits

## HOW TO USE

### Step 1 — Get an API key (wallet signature required)

#### 1a — Request a challenge nonce
GET https://liquidconway.xyz/api/keys/challenge?wallet=0xYOUR_WALLET

Response:
{
  "success": true,
  "nonce":   "abc123...",
  "message": "Register for Conway Liquid API\nWallet: 0x...\nNonce: abc123...\nDomain: conwayliquid.vercel.app",
  "expires_in": 300
}

#### 1b — Sign the message (EIP-191 personal_sign)
Sign the exact message string with your wallet private key.
Result: a 0x... hex signature.

```bash
cast wallet sign --private-key $PRIVATE_KEY "Register for Conway Liquid API\nWallet: 0x...\nNonce: abc123..."
```

#### 1c — Register and receive API key
POST https://liquidconway.xyz/api/keys/register
Content-Type: application/json

{
  "wallet":    "0xYOUR_WALLET",
  "nonce":     "abc123...",
  "signature": "0x...",
  "name":      "my-agent"    // optional label
}

Response: { "success": true, "key": "cl_..." }

### Step 2 — Deploy a token

POST https://liquidconway.xyz/api/deploy
x-api-key: cl_your_key_here
Content-Type: application/json

REQUIRED FIELDS:
{
  "name":         "My Agent Token",     // Token full name
  "symbol":       "MAT",               // 1–12 chars, letters/numbers
  "clientWallet": "0x..."              // Your wallet — receives 80% LP fees forever
}

ALL OPTIONAL FIELDS:
{
  "hookType":     "dynamic",           // "dynamic" (default) or "static"
  "description":  "What this token does",
  "image":        "https://...",       // Token image, pinned to IPFS
  "website":      "https://...",
  "twitter":      "@handle",
  "vaultPercent": 20,                  // 0–90 — % supply locked with linear vesting
  "vaultDays":    30,                  // Min 7 days (default 7)
  "devBuyEth":    "0.05"              // ETH to swap for tokens at deploy
}

SUCCESS RESPONSE (201):
{
  "success": true,
  "token": {
    "address":   "0x...",
    "name":      "My Agent Token",
    "symbol":    "MAT",
    "txHash":    "0x...",
    "supply":    "100000000000",
    "hookType":  "dynamic",
    "links": {
      "liquid":      "https://app.liquidprotocol.org/tokens/0x...",
      "basescan":    "https://basescan.org/address/0x...",
      "dexscreener": "https://dexscreener.com/base/0x...",
      "uniswap":     "https://app.uniswap.org/swap?outputCurrency=0x...&chain=base"
    }
  }
}

### Step 3 — Check your tokens

GET https://liquidconway.xyz/api/tokens
GET https://liquidconway.xyz/api/tokens?limit=10&offset=0
GET https://liquidconway.xyz/api/tokens/0xTOKEN_ADDRESS
GET https://liquidconway.xyz/api/tokens?wallet=0xYOUR_WALLET

### Step 4 — Platform stats

GET https://liquidconway.xyz/api/stats

## ERROR CODES
| Code | Meaning                                      |
|------|----------------------------------------------|
| 400  | Bad request — missing or invalid fields      |
| 401  | Missing x-api-key header                     |
| 403  | Invalid or already-used API key              |
| 422  | Validation error — check field formats       |
| 500  | Deploy failed — check wallet ETH balance     |

## LIQUID PROTOCOL DETAILS
- Factory:    0x04F1a284168743759BE6554f607a10CEBdB77760
- LP Locker:  0x77247fCD1d5e34A3703AcA898A591Dc7422435f3
- Chain:      Base (8453)
- Supply:     100,000,000,000 tokens (18 decimals)
- LP:         Permanently locked — no unlock mechanism
- Fees:       80% creator / 20% protocol of all LP trading fees
- Hooks:      Dynamic (volatility-adaptive) or Static (fixed rate)
- MEV:        Block delay + sniper auction on all deploys

## QUICK CURL EXAMPLE

```bash
# 1. Get challenge
NONCE=$(curl -s "https://liquidconway.xyz/api/keys/challenge?wallet=0xYOUR_WALLET" | jq -r .nonce)
MSG=$(curl -s "https://liquidconway.xyz/api/keys/challenge?wallet=0xYOUR_WALLET" | jq -r .message)

# 2. Sign
SIG=$(cast wallet sign --private-key $PRIVATE_KEY "$MSG")

# 3. Register
KEY=$(curl -s -X POST https://liquidconway.xyz/api/keys/register \
  -H "Content-Type: application/json" \
  -d '{"wallet":"0xYOUR_WALLET","nonce":"'$NONCE'","signature":"'$SIG'"}' \
  | jq -r .key)

# 4. Deploy
curl -X POST https://liquidconway.xyz/api/deploy \
  -H "x-api-key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Token",
    "symbol": "MTK",
    "clientWallet": "0xYOUR_WALLET"
  }'
```

## AUTOMATON COMPATIBILITY (Conway Research)

Conway Liquid is natively compatible with Conway Research Automaton agents.
Automaton agents have a built-in Ethereum wallet and can authenticate + deploy tokens fully autonomously.

### Native SIWE Flow (recommended for Automaton agents)

Instead of the manual 3-step EIP-191 flow, use the SIWE endpoint:

#### Step 1 — Get a SIWE challenge
GET https://liquidconway.xyz/api/keys/siwe?wallet=0xAGENT_WALLET

Response:
{
  "success": true,
  "nonce":   "abc123...",
  "message": "conwayliquid.vercel.app wants you to sign in with your Ethereum account:\n0x...\n\nRegister for Conway Liquid API\n\nURI: ...\nVersion: 1\nChain ID: 8453\nNonce: abc123...\nIssued At: ...",
  "expires_in": 300
}

#### Step 2 — Sign the SIWE message with your agent wallet (EIP-191)
Use your Automaton wallet's signMessage() on the exact message string.

#### Step 3 — Register and receive API key
POST https://liquidconway.xyz/api/keys/siwe
Content-Type: application/json

{
  "message":   "...",   // exact SIWE message from Step 1
  "signature": "0x...", // EIP-191 signature
  "name":      "my-automaton-agent"  // optional label
}

Response: { "success": true, "key": "cl_..." }

#### Step 4 — Deploy a token (same as standard flow)
POST https://liquidconway.xyz/api/deploy
x-api-key: cl_your_key_here

{
  "name":         "Automaton Token",
  "symbol":       "AUTO",
  "clientWallet": "0xAGENT_WALLET"
}

### Automaton Skill Loading
Automaton agents can load this skill file via:
  GET https://liquidconway.xyz/api/skill   (returns this document)

Then authenticate and deploy autonomously using the SIWE flow above.
Compatible with ERC-8004 agent identity and Conway Cloud.

## SUPPORT
Twitter/X: @conwayliquid
Docs:      https://liquidconway.xyz/docs
Skill:     https://liquidconway.xyz/skill