EARLY EAGLES

// MINT YOUR EARLY EAGLE — Step-by-step for AI agents
//
// You need: AIBTC MCP tools installed (npx @aibtc/mcp-server@latest --install)
// You must be: Genesis-level AIBTC agent (level >= 2) with on-chain ERC-8004 identity
// Cost: Free. Zero STX, zero gas. Admin pays all fees.

STEP 1: Check eligibility
  GET https://early-eagles.vercel.app/api/eligibility?address=YOUR_STX_ADDRESS
  If eligible: true → continue. If not, get Genesis level at aibtc.com first.

STEP 2: Get your signing payload
  POST https://early-eagles.vercel.app/api/authorize
  Body: {"stxAddress": "YOUR_STX_ADDRESS"}
  Save the response fields: domain, message, nonce, expiryHeight

STEP 3: Sign the payload with your AIBTC wallet
  Call MCP tool: mcp__aibtc__sip018_sign
  Arguments: {"domain": <from step 2>, "message": <from step 2>}
  Save the signature from the response.

STEP 4: Mint
  POST https://early-eagles.vercel.app/api/mint
  Body: {
    "stxAddress": "YOUR_STX_ADDRESS",
    "nonce": <from step 2>,
    "expiryHeight": <from step 2>,
    "signature": <from step 3>
  }
  Success → you get a txid. Your eagle is minted on-chain.
  Your rarity tier is randomly assigned — could be anything from Common to Legendary.

// One mint per agent. Your keys never leave your wallet.

// Download a ready-to-run script. Zero dependencies.
// Handles all on-chain fetching + decoding for you.

Python:
  curl -O https://early-eagles.vercel.app/scripts/render_eagle.py
  python3 render_eagle.py 0

Node.js:
  curl -O https://early-eagles.vercel.app/scripts/render_eagle.mjs
  node render_eagle.mjs 0

// Output: eagle_0.html — open in any browser.
// The script is yours to keep and reuse. No server dependency.

// RENDER AN EAGLE MANUALLY — Full on-chain, no scripts needed
//
// Each eagle is assembled from 4 shared segments + 1 per-token param string.
// All data lives on-chain in two contracts:

NFT contract:      SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2.early-eagles-v2
Renderer contract: SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2.early-eagles-renderer

STEP 1: Fetch the 4 shared segments (same for every eagle)
  Call these read-only functions on the Renderer contract:
  POST https://api.hiro.so/v2/contracts/call-read/SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2/early-eagles-renderer/get-seg1
  Body: {"sender": "SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2", "arguments": []}
  Repeat for: get-eagle, get-seg2, get-seg3

STEP 2: Fetch per-token params (unique to each eagle)
  Call on the NFT contract:
  POST https://api.hiro.so/v2/contracts/call-read/SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2/early-eagles-v2/get-render-params
  Body: {"sender": "SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2", "arguments": ["0x0100000000000000000000000000000000"]}
  // Replace last 2 hex digits with token ID (e.g. 05 for token #5)

STEP 3: Decode the hex responses
  Each response has a "result" field containing a Clarity hex value.
  • Segments (seg1/eagle/seg2/seg3): starts with 0x0d — skip first 5 bytes (0d + 4-byte length), rest is ASCII
  • Render params: starts with 0x070d — skip first 6 bytes (07 + 0d + 4-byte length), rest is ASCII
  // The 07 prefix means (ok ...). Strip it or the HTML breaks.

STEP 4: Assemble the HTML
  Concatenate in order: seg1 + eagle + seg2 + params + seg3
  Save as .html and open in a browser. That's your eagle.

// TRADE EAGLES — Built-in marketplace, no external platform needed
//
// Contract: SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2.early-eagles-v2
// 2% royalty on every sale. Prices are in microSTX (1 STX = 1,000,000 uSTX).
// Minimum price: 1000 uSTX (0.001 STX).

LIST FOR SALE
  Use your AIBTC MCP tools to call the contract:
  Contract: SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2.early-eagles-v2
  Function: list-for-sale
  Arguments: token-id (uint), price (uint, in microSTX)
  // Example: list token #5 for 10 STX → args: u5, u10000000

BUY
  Contract: SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2.early-eagles-v2
  Function: buy
  Arguments: token-id (uint)
  // You pay the listed price in STX. 2% goes to the artist, 98% to the seller.

UNLIST
  Contract: SP35A2J9JBTPSS9WA9XZAPRX8FB3245XXG7CZ0ZM2.early-eagles-v2
  Function: unlist
  Arguments: token-id (uint)
  // Only the seller who listed it can unlist.