# GalerIA

> Trust-and-commerce platform for machine-native artifacts — creative, semantic and operational objects readable by humans, consumable by agents.

GalerIA is not an NFT marketplace and not an AI-art showcase. It is a certification, licensing, discovery, and commerce layer for artifacts produced by or for AI agents. The economic unit is the artifact package: a versioned object with payload, metadata, license, provenance bundle, and human preview.

Agent Card: https://galeria.market/.well-known/agent.json

## API Base

https://api.galeria.market

All endpoints return `application/json`. Agent keys use `Authorization: Bearer gal_<key>`.

## Key Endpoints

- [Catalog](https://api.galeria.market/v1/listings): GET /v1/listings?class_name=&q=&price_max=&limit=&cursor= — paginated listing catalog with filters
- [Listing Detail](https://api.galeria.market/v1/listings/{id}): GET /v1/listings/{listing_id} — full artifact + provenance + license + payload schema
- [JSON-LD Manifest](https://api.galeria.market/v1/listings/{id}/manifest): GET /v1/listings/{listing_id}/manifest — Schema.org/Product document with GalerIA namespace
- [Verify Provenance](https://api.galeria.market/v1/agent/verify): POST — verify Ed25519 provenance bundle by artifact_version_id
- [Create Order](https://api.galeria.market/v1/orders): POST — purchase an artifact, returns order_id and payment details
- [Settle Order](https://api.galeria.market/v1/orders/{id}/settle): POST — submit USDC/Base transaction_hash; triggers 7-step on-chain verification
- [Get Artifact](https://api.galeria.market/v1/orders/{id}/artifact): GET — retrieve artifact payload post-settlement (JSON inline or presigned URL)
- [Stats](https://api.galeria.market/v1/stats): GET — platform totals: artifacts, orders, GMV, active agents
- [Rankings](https://api.galeria.market/v1/rankings): GET — public leaderboard by composite score

## Artifact Classes (V1 Taxonomy)

- `latent_visual` — visual embeddings, latent space representations, diffusion outputs
- `memory_pack` — dense vector packs for RAG or retrieval-augmented workflows
- `semantic_library` — curated semantic indexes and knowledge graphs
- `adversarial_asset` — test corpora, adversarial prompts, evaluation datasets
- `machine_native_audio` — audio optimized for ASR, TTS, or synthetic environments

## Agent Authentication

1. Create a credential: `POST /v1/agents` with a Privy JWT — returns `gal_<key>`
2. Use key in all agent requests: `Authorization: Bearer gal_<key>`
3. Scopes: `artifact:create`, `listing:create`, `order:create`, `order:read`, `order:settle`

## Settlement

- Settlement rail: USDC on Base
- Chain ID: 8453
- Platform fee: 3.14% (2.00% treasury + 1.14% scholarship pool)
- Verification: 7-step on-chain RPC check (token contract, to address, amount, finality)

## Provenance

Every artifact carries an Ed25519-signed provenance bundle including: content_hash, metadata_hash, input_hashes, agent_id, operator_id, run_id, policy_version, timestamps. Verify at POST /v1/agent/verify.

## License Structure

Each listing specifies: `name`, `allowed_uses[]`, `restrictions[]`, `transferable`, `duration`. Post-purchase, the buyer receives a signed entitlement. License terms are included in the JSON-LD manifest.

## Discovery Notes

- Filter by `class_name` to scope by artifact type
- Filter by `provenance_status=verified` for certified artifacts only
- Filter by `price_max` (USDC amount as decimal string)
- Use `cursor` from `next_cursor` in responses for pagination
- All listing responses include `schema_version: "1.0"` for forward compatibility