# Framework de Documentación de Instrumentos — Economía Real en BSC

## Principio Fundamental

> No estamos construyendo variantes DeFi. Estamos creando un ecosistema de **economía REAL en Binance Smart Chain**.

Cada instrumento tokenizado representa un bien, servicio o actividad económica que existe fuera de la cadena. El token no es un derivado financiero especulativo — es un **comprobante de titularidad sobre valor económico real**.

## Estructura Obligatoria de Cada Instrumento

Cada archivo `ISO-descriptivo.md` debe contener estas 8 secciones:

### 1. IDENTIFICACIÓN DEL INSTRUMENTO
```
ISO/ID: [código único]
Nombre: [nombre descriptivo]
Tipo: [dinero | materia_prima | energia | ganaderia | token_ecosistema | cripto | economia_real]
Token BSC: [nombre del token_g si aplica]
Contrato: [dirección del contrato si existe]
```

### 2. PROPÓSITO EN LA ECONOMÍA REAL
Explicar qué actividad económica real representa. No basta con "es una moneda" o "es un commodity". Hay que describir:
- ¿Quién produce este bien/servicio?
- ¿Quién lo consume?
- ¿Qué problema resuelve en la economía real?
- ¿Por qué alguien querría poseerlo?

### 3. CADENA DE VALOR (Producción → Transformación → Consumo)
Describir el ciclo de vida económico:
- **Producción/Extracción**: Cómo se obtiene
- **Transformación**: Cómo se procesa
- **Comercialización**: Cómo se negocia
- **Consumo final**: Quién lo usa y para qué

### 4. TOKENIZACIÓN Y CRITERIO DE CRISTALIZACIÓN
Explicar cómo el instrumento se convierte en token BSC:
- **Relación 1:1**: Cada token = unidad específica del activo real
- **Puente BNB**: El inversor cristaliza BNB en el Vault y recibe el token equivalente
- **Irreversibilidad**: El BNB depositado respalda el token; no hay redención (redeem)
- **Utilidad del token**: El tenedor puede transferir, comercializar o intercambiar por otros tokens del ecosistema

### 5. USABILIDAD Y MERCADO OBJETIVO
Segmentar los usuarios reales:
- **Productores**: Quienes generan el bien real → pueden vender sus tokens como representación de su producción
- **Comerciantes**: Quienes distribuyen → pueden usar los tokens como medio de intercambio
- **Inversores**: Quienes quieren exposición al precio del bien sin tenencia física
- **Consumidores**: Quienes necesitan el bien para consumo propio

### 6. IMPACTO (Económico, Social, Ambiental)
Evaluación cualitativa:
- **Económico**: ¿Cómo impacta en la economía local/global?
- **Social**: ¿Genera empleo? ¿Mejora calidad de vida?
- **Ambiental**: ¿Es sostenible? ¿Reduce huella de carbono?

### 7. DATOS DE MERCADO Y REFERENCIAS
- Unidad de medida estándar
- Precio de referencia internacional
- Bolsa o mercado donde se negocia
- Ticker de futuros (si aplica)
- Contrato estándar (tamaño, unidades)
- **Fuentes**: Enlaces a documentación científica, artículos, datos de mercado
- **ISO/estándar**: Códigos ISO, estándares internacionales

### 8. REFERENCIAS BIBLIOGRÁFICAS Y ENLACES VERIFICABLES
Lista de:
- Artículos científicos (DOI, PubMed, arXiv)
- Reportes de organismos internacionales (World Bank, IMF, FAO, IEA, UNCTAD)
- Páginas de producto y proceso industrial
- Mercados de futuros (CME, ICE)
- Documentación técnica del proceso

## Criterios de Evaluación para Nuevos Instrumentos

Para proponer un nuevo instrumento, debe cumplir TODOS estos criterios:

1. **EXISTENCIA REAL**: El bien/servicio debe producirse o existir físicamente en la economía real. No se tokenizan conceptos abstractos sin respaldo productivo.

2. **DEMANDA COMPROBABLE**: Debe existir un mercado real de compradores y vendedores del bien subyacente.

3. **UNIDAD ESTÁNDAR**: El bien debe poder medirse en unidades estandarizadas (kg, L, m³, unidades, etc.).

4. **PRECIO REFERENCIABLE**: Debe existir un precio de mercado transparente y verificable.

5. **IMPACTO POSITIVO**: El instrumento debe generar beneficio económico, social o ambiental medible.

6. **BARRERA DE ENTRADA RAZONABLE**: Actividades como pirólisis de plásticos, reciclaje, agricultura familiar, deben tener costos de entrada accesibles para personas naturales.

7. **NO DEPENDENCIA ESTATAL**: El modelo de negocio no debe depender de subsidios, regulaciones gubernamentales o controles de precios para ser viable.

## Categorías de Instrumentos

### Dinero (Fiat)
Monedas fiduciarias emitidas por bancos centrales. Su tokenización permite exponerse al tipo de cambio de cualquier moneda del mundo sin necesidad de cuentas bancarias internacionales.

### Materias Primas (Commodities Agrícolas e Industriales)
Bienes básicos producidos por la agricultura, minería e industria extractiva. Cada commodity tokenizado representa una cantidad específica del bien físico.

### Energía
Fuentes energéticas: petróleo, gas natural, gasolina, carbón, electricidad. La tokenización energética permite a productores y consumidores gestionar riesgo de precio.

### Ganadería y Proteína Animal
Ganado bovino, porcino y sus derivados. Representa la cadena de valor cárnica.

### Tokens del Ecosistema
GOLDT, GOLDVE, FIAT_g, FIAT_f — tokens nativos del sistema Criptoinversiones en BSC.

### Criptoactivos
Bitcoin, Ethereum, BNB, etc. — activos digitales nativos de blockchain.

### Economía Real (Nuevos Instrumentos)
Actividades económicas innovadoras con impacto social/ambiental: reciclaje, pirólisis, agricultura regenerativa, economía circular.

## Ejemplo de Narrativa: Gasolina_pirolisis

> La pirólisis de plásticos convierte residuos plásticos en combustible líquido (gasolina/diésel sintético) mediante degradación térmica en ausencia de oxígeno. Por cada 100 kg de plástico (polietileno, polipropileno), el rendimiento promedio documentado es de 50-80 litros de combustible (dependiendo de la tecnología y calidad del plástico). Esto significa que un productor con un kit de pirólisis doméstico puede procesar 100 kg/día de plástico y obtener ~50 L de gasolina sintética.
>
> Tokenizar este proceso significa que cualquier persona puede cristalizar BNB en un contrato de 100 litros de gasolina de pirólisis, y ese contrato puede ser cambiado 1:1 con el productor que convierte plástico en combustible. El productor acepta el token como comprobante de entrega futura, y el tenedor puede venderlo por cualquier cripto del ecosistema o existente en BSC.

## Herramientas de Referencia para Consulta de Precios

- **World Bank Pink Sheet**: Precios de commodities (worldbank.org/en/research/commodity-markets)
- **CME Group**: Futuros agrícolas, energéticos, metales (cmegroup.com)
- **ICE Futures**: Energía, softs, carbono (theice.com)
- **FAO Food Price Index**: Índices de precios de alimentos (fao.org)
- **EIA**: Energía (eia.gov)
- **LBMA**: Metales preciosos (lbma.org.uk)
- **LME**: Metales industriales (lme.com)
- **S&P Global Platts**: Commodities energéticos y petroquímicos

---

## 9. FÓRMULA DE VALORACIÓN — Formalización Matemática

Cada instrumento debe incluir una fórmula explícita de su precio tokenizado. La fórmula general es:

```
P_token(BNB) = (Q_base × P_reference(USD)) / (P_BNB(USD) × SF)
```

Donde:
- **P_token(BNB)** = Precio del token instrumento en BNB (cantidad de BNB por 1 token)
- **Q_base** = Cantidad base del bien físico que representa 1 token (en kg, L, oz, barriles, etc.)
- **P_reference(USD)** = Precio de referencia del bien en USD por unidad estándar (fuente: CME, World Bank, LBMA, etc.)
- **P_BNB(USD)** = Precio de BNB en USD (fuente: Oracle BNB/USD)
- **SF** = Factor de escala (10^decimales) para ajuste de precisión del contrato

### Ejemplo: MAIZ_g (Maíz)
```
Q_base = 1 bushel (25.4 kg)
P_reference = $4.50/bushel (CBOT)
P_BNB = $600
SF = 1 (sin decimales extra)

P_token = (1 × $4.50) / ($600 × 1) = 0.0075 BNB por MAIZ_g
```

### Fórmula para Índices de Categoría (Capa 2)

```
P_index = Σ(i=1..N) [ w_i × P_component_i ]

Donde:
  w_i = weightBps_i / 10000  (peso normalizado)
  P_component_i = precio del instrumento componente i en USD
```

### Fórmula para Índice Nacional VZ_ECON (Capa 3)

```
P_VZ_ECON = Σ(c=1..8) [ w_c × P_index_c ]

Donde:
  w_c = peso de la categoría c (ENER 0.35, MIN 0.18, AGRI 0.15, etc.)
  P_index_c = precio del índice de categoría c en USD
```

### Fórmula de Fee de Minteo

```
Tokens_recibidos = (BNB_depositado × (1 - feeBps / 10000)) / P_token
Fee_BNB = BNB_depositado × feeBps / 10000  → enviado al Vault GOLDVE
```

Donde feeBps = 100 (1%) para todos los instrumentos e índices.

### Fórmula de Fee de Transferencia

```
Monto_neto_recibido = Monto_enviado  (no se descuenta del receptor)
Monto_adicional_pagado = Monto_enviado × feeBps / 10000  (pagado por el remitente adicionalmente)
```

El fee de transferencia es **adicional del remitente** — no se descuenta del monto enviado. El remitente paga 1% extra en tokens sobre la cantidad enviada.

---

## 10. RAZONAMIENTO — Los 7 Criterios de Evaluación

Cada instrumento debe evaluarse explícitamente contra estos 7 criterios. La tabla debe incluirse en la documentación:

| # | Criterio | Cumple | Evidencia |
|---|----------|--------|-----------|
| 1 | **EXISTENCIA REAL** | Sí/No | ¿Dónde se produce o existe físicamente? |
| 2 | **DEMANDA COMPROBABLE** | Sí/No | ¿Quién lo compra y vende? ¿Qué volumen? |
| 3 | **UNIDAD ESTÁNDAR** | Sí/No | ¿Qué unidad? ¿ISO/estándar internacional? |
| 4 | **PRECIO REFERENCIABLE** | Sí/No | ¿Qué fuente? ¿Qué bolsa? |
| 5 | **IMPACTO POSITIVO** | Alto/Medio/Bajo | ¿Económico, social o ambiental? |
| 6 | **BARRERA DE ENTRADA RAZONABLE** | Sí/No | ¿Puede una persona natural participar? |
| 7 | **NO DEPENDENCIA ESTATAL** | Sí/No | ¿Depende de subsidios o regulaciones? |

### Notas para la Evaluación

- **Existencia real**: Se refiere a producción física verificable. No se tokenizan conceptos abstractos.
- **Demanda comprobable**: Debe haber un mercado activo. No se tokenizan bienes sin transacciones reales.
- **Unidad estándar**: Debe existir una convención internacional de medida para el bien.
- **Precio referenciable**: Debe existir un precio público, transparente y verificable (bolsa, índice gubernamental, publicació́n periódica).
- **Impacto positivo**: El instrumento debe generar beneficio medible en al menos una dimensión.
- **Barrera de entrada razonable**: El costo de entrada para productores/consumidores debe ser accesible (no solo corporaciones multinacionales).
- **No dependencia estatal**: El modelo debe ser viable sin subsidios, controles de precios o beneficios fiscales.

---

## 11. OBJETIVOS ECONÓMICOS — Propósito en el Ecosistema GOLDT

Cada instrumento debe declarar sus objetivos económicos en el contexto del ecosistema:

### Objetivos Principales (aplica a todos)
1. **Inclusión financiera**: Permitir que cualquier persona con BNB tenga exposición a la economía real venezolana y global sin intermediarios bancarios.
2. **Cobertura inflacionaria**: Activos reales como protección contra devaluación de monedas fiduciarias.
3. **Liquidez de bienes reales**: Convertir bienes ilíquidos (cosechas, minerales, ganado) en tokens líquidos transferibles 24/7.

### Objetivos por Tipo de Instrumento

| Tipo | Objetivo Primario | Objetivo Secundario |
|------|-------------------|---------------------|
| **Dinero (FIAT)** | Exposición a tipo de cambio sin cuenta bancaria | Remesas, cobertura cambiaria |
| **Materia Prima** | Exposición a precio de commodity global | Cobertura para productores agrícolas |
| **Energía** | Exposición a precios energéticos | Cobertura inflacionaria (energía = insumo universal) |
| **Minería** | Exposición a recursos minerales venezolanos | Canal de inversión en sector minero formal |
| **Pecuario** | Exposición a proteína animal | Cobertura de inflación alimentaria |
| **Pesca** | Exposición a recursos pesqueros | Sostenibilidad pesquera vía trazabilidad tokenizada |
| **Agricultura tropical** | Exposición a cultivos tropicales | Financiamiento a pequeños productores |
| **Nueva Economía** | Economía circular y reciclaje | Innovación social y ambiental |
| **Canasta/Índice** | Exposición diversificada a un sector | Reducción de volatilidad por diversificación |
| **Token Ecosistema** | Liquidez y gobernanza del sistema | Colateral para operaciones |

### Objetivos Transversales
- **Trazabilidad**: Cada token representa titularidad sobre un bien real con cadena de valor documentada.
- **Descentralización progresiva**: El sistema migra de oráculo centralizado a fuentes descentralizadas con el tiempo.
- **Interoperabilidad**: Todos los instrumentos son intercambiables entre sí dentro del ecosistema.
- **Educación financiera**: Cada instrumento documenta su economía real, enseñando al tenedor sobre el bien subyacente.

---

*Framework v2.0 — Ecosistema Criptoinversiones. Todo instrumento debe responder a la pregunta: "¿Qué valor económico real representa este token fuera de la blockchain?"*