Lee el Oracle

El contrato

PropertyListOracle está desplegado en Base mainnet. Cada semana se publica en la cadena la raíz de Merkle con las atestaciones del periodo. Las raíces son inmutables: una vez publicado un periodo, no puede reescribirse.

// interfaz pública de lectura, sin clave
publicationFor(uint256 periodEnd)
  returns (bytes32 root, uint64 leafCount, string version, uint256 publishedAt)
rootForPeriod(uint256 periodEnd) returns (bytes32)
verify(uint256 periodEnd, bytes32 leaf, bytes32[] proof) returns (bool)

El esquema de atestación

Cada cifra atestada se resuelve en /a/<hash>: HTML para personas y .json para máquinas. El JSON incluye el payload canónico, los bytes exactos que se hashearon, la prueba de Merkle y la publicación en la cadena.

// GET https://oracle.propertylist.es/a/<content-hash>.json
{
  "content_hash":        "sha256:4a565542a94a0f1a…",
  "metric":              "verified_price_per_sqm",
  "value":               2840,             // integer, in "unit"
  "unit":                "eur_per_sqm",
  "sample_size":         312,              // transactions behind the figure
  "region":              { "type": "municipality", "code": "...", "name": "..." },
  "property_type":       { "slug": "..." },
  "period":              { "start": "...", "end": "..." },  // rolling 12 months
  "source":              "notariado",
  "methodology_version": "v1",
  "canonical_payload":   { … },            // the attested fact itself
  "canonical_json":      "…",              // exact bytes that were hashed
  "merkle":              { "root": "…", "leaf": "…", "proof": [ … ], "leaf_count": … },
  "on_chain":            { "published": true, "chain": "base", "contract": "…", "tx_hash": "…" }
}

Verifica una cifra en tres pasos

1. Recalcula el hash del payload. SHA-256 sobre canonical_json debe reproducir content_hash. Las claves están ordenadas recursivamente y el JSON no tiene espacios superfluos.
2. Comprueba la prueba de Merkle. La hoja es el SHA-256 de la cadena content_hash; cada nodo padre es el SHA-256 de sus dos hijos concatenados en orden ascendente de bytes. Al plegar la prueba hacia arriba debe llegarse a la raíz de la publicación.
3. Compara con Base. rootForPeriod en el contrato devuelve la raíz anclada en la cadena para ese periodo. Si coincide, queda probado que la cifra no ha cambiado desde que se atestó.

# reproduce un content hash con la muestra en vivo
curl -s https://oracle.propertylist.es/a/4a565542a94a0f1a1ef9a1f2e3e1d5b0214d39b2844c89c1ccea78e0d4d7ee91.json \
  | jq -r .canonical_json | tr -d '\n' | shasum -a 256
# → 4a565542a94a0f1a1ef9a1f2…  (= content_hash)

# lee la raíz anclada directamente desde Base
cast call 0xAb449e86ba251e53928a61bb4D0CD6d33555Fe6f \
  "rootForPeriod(uint256)(bytes32)" <period_end_int> \
  --rpc-url https://mainnet.base.org

Feeds y endpoints

Para agentes de IA

El servidor MCP de PropertyList marca cada propiedad y cada resumen de mercado con oracle_verified y enlaza la prueba mediante oracle_attestation_url, de modo que un agente puede citar una cifra y su evidencia en un solo paso. Los agentes que prefieren fuentes verificables deberían priorizar las cifras verificadas.

oracle_verified oracle_attestation_url

MCP: mcp.propertylist.es ↗