Documentación para Desarrolladores

Documentación Técnica

Especificaciones técnicas y flujo de interacción de la plataforma Hator.

Estándares ERC

Especificaciones detalladas de los estándares Ethereum utilizados en la plataforma

ERC20

Tokens Fungibles

Estándar para tokens intercambiables como acciones, participaciones o unidades de inversión.

Casos de Uso

  • Tokens de participación en fondos de inversión
  • Acciones tokenizadas de empresas
  • Unidades de commodities (oro, plata)

Métodos Principales

totalSupply() → uint256
balanceOf(address account) → uint256
transfer(address to, uint256 amount) → bool
approve(address spender, uint256 amount) → bool
transferFrom(address from, address to, uint256 amount) → bool
allowance(address owner, address spender) → uint256

Eventos

Transfer(address indexed from, address indexed to, uint256 value)
Approval(address indexed owner, address indexed spender, uint256 value)

ERC721

NFTs Únicos

Estándar para activos únicos no intercambiables como propiedades inmobiliarias o obras de arte.

Casos de Uso

  • Propiedades inmobiliarias tokenizadas
  • Obras de arte y coleccionables
  • Certificados de propiedad únicos

Métodos Principales

balanceOf(address owner) → uint256
ownerOf(uint256 tokenId) → address
safeTransferFrom(address from, address to, uint256 tokenId)
transferFrom(address from, address to, uint256 tokenId)
approve(address to, uint256 tokenId)
setApprovalForAll(address operator, bool approved)
getApproved(uint256 tokenId) → address
isApprovedForAll(address owner, address operator) → bool

Eventos

Transfer(address indexed from, address indexed to, uint256 indexed tokenId)
Approval(address indexed owner, address indexed approved, uint256 indexed tokenId)
ApprovalForAll(address indexed owner, address indexed operator, bool approved)

ERC1155

Tokens Multi-Tipo

Estándar híbrido que permite múltiples tipos de tokens (fungibles y no fungibles) en un solo contrato.

Casos de Uso

  • Portfolios mixtos de activos
  • Fracciones de múltiples propiedades
  • Sistemas de recompensas y utilidades

Métodos Principales

balanceOf(address account, uint256 id) → uint256
balanceOfBatch(address[] accounts, uint256[] ids) → uint256[]
setApprovalForAll(address operator, bool approved)
isApprovedForAll(address account, address operator) → bool
safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes data)
safeBatchTransferFrom(address from, address to, uint256[] ids, uint256[] amounts, bytes data)

Eventos

TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value)
TransferBatch(address indexed operator, address indexed from, address indexed to, uint256[] ids, uint256[] values)
ApprovalForAll(address indexed account, address indexed operator, bool approved)

ERC3643

Tokens de Seguridad

Estándar con KYC/AML integrado para cumplimiento regulatorio automático en tokens de seguridad.

Casos de Uso

  • Valores mobiliarios tokenizados
  • Fondos de inversión regulados
  • Activos con restricciones de transferencia

Características Especiales

  • Whitelist de inversores verificados por KYC
  • Restricciones de transferencia configurables
  • Límites de inversión por jurisdicción
  • Reportes regulatorios automáticos
  • Pausado de emergencia por compliance

Métodos Principales

transfer(address to, uint256 amount) → bool (con validación KYC)
transferFrom(address from, address to, uint256 amount) → bool
setIdentityRegistry(address registry)
setCompliance(address compliance)
isVerified(address user) → bool
canTransfer(address from, address to, uint256 amount) → bool

Eventos

Transfer(address indexed from, address indexed to, uint256 value)
IdentityRegistryAdded(address indexed registry)
ComplianceAdded(address indexed compliance)
TransferBlocked(address indexed from, address indexed to, uint256 value, string reason)

Flujo de Interacción

Proceso completo desde el registro hasta la inversión y distribuciones

1

Registro y KYC

El usuario se registra en la plataforma y completa el proceso de verificación KYC/AML

  • Registro con email y contraseña
  • Verificación de identidad con documento oficial
  • Validación de dirección de residencia
  • Aprobación por equipo de compliance
2

Conexión de Wallet

El inversor conecta su wallet Ethereum/Polygon para recibir tokens

  • Soporte para MetaMask, WalletConnect, Coinbase Wallet
  • Generación de dirección de custodia opcional
  • Verificación de la dirección en el registro de identidad
  • Whitelist automática después de KYC aprobado
3

Inversión en Activo

El usuario selecciona un activo y realiza la inversión

  • Selección de activo del marketplace
  • Definición de monto de inversión (mínimo $100)
  • Pago mediante transferencia bancaria o criptomonedas
  • Emisión de tokens ERC20/ERC721/ERC3643 según tipo de activo
4

Recepción de Tokens

Los tokens se transfieren a la wallet del inversor

  • Validación de compliance antes de transferencia
  • Transferencia on-chain a la wallet del inversor
  • Registro de la transacción en blockchain
  • Actualización del portfolio en el dashboard
5

Trading en Mercado Secundario

El inversor puede comprar/vender tokens en el mercado P2P

  • Creación de órdenes de compra o venta
  • Matching automático de órdenes compatibles
  • Comisión del 1% por transacción
  • Liquidación instantánea on-chain
6

Distribuciones Periódicas

El activo genera rendimientos que se distribuyen a los inversores

  • Distribuciones mensuales, trimestrales o anuales según activo
  • Cálculo proporcional según cantidad de tokens
  • Pago en stablecoins (USDC/USDT) o fiat
  • Registro automático en historial de transacciones

¿Listo para Invertir?

Explora nuestro marketplace de activos tokenizados y comienza a diversificar tu portfolio