Caso de Estudio: Construyendo FilmFund, una plataforma on-chain de financiación de cine que cumple con la regulación

La versión corta

El cine independiente tiene un problema de dinero que no tiene nada que ver con el talento. Los guiones existen. Los directores existen. El público existe. Lo que casi nunca existe es una forma limpia, legal y transparente de que gente común ponga un poco de dinero detrás de una película en la que cree y vea de verdad a dónde va ese dinero.

FilmFund se propuso arreglar exactamente eso. Es una plataforma donde los cineastas levantan capital de una multitud de pequeños inversores, donde cada dólar de financiación queda en custodia y registrado on-chain, donde los inversores tienen una participación legal real en la película a través de un token de seguridad regulado, y donde los fans que ayudan a promocionar un proyecto ganan recompensas por el trabajo de marketing que hacen.

Construimos todo: los smart contracts, la base de datos, los dashboards, los flujos de cumplimiento y una capa de herramientas de IA que ayuda a los creadores a pasar de “tengo una idea” a “tengo un guion”. Esta es la historia de cómo encajan las piezas y de las decisiones que lo hicieron funcionar.

El problema que de verdad estábamos resolviendo

Si alguna vez miraste de cerca la financiación de cine, sabes que es un enredo. El dinero viene de un mosaico de subsidios, incentivos fiscales, capital privado y favores. Los inversores entregan capital y después esperan, muchas veces con muy poca visibilidad de cómo gasta la producción o de si alguna vez verán un retorno. Las plataformas de crowdfunding resolvieron el problema del acceso pero crearon uno nuevo: los que aportan suelen recibir una remera y un agradecimiento, no participación.

Así que FilmFund tenía tres objetivos que tiraban en direcciones distintas:

Dejar que cualquiera invierta montos pequeños en una película que le guste.
Darles a esos inversores un interés económico genuino y exigible en la película, no un beneficio simbólico.
Mantenerse dentro de la ley, porque en el momento en que le vendes a alguien una porción de las ganancias futuras, estás vendiendo un valor (security).

Conciliar esos tres es todo el desafío de ingeniería y de producto. Un token cripto puro habría sido fácil e inútil. Un fondo tradicional habría cumplido la regulación y sido inaccesible. El trabajo interesante vivía en el medio.

La arquitectura de un vistazo

La plataforma corre como un sistema híbrido. Todo lo que necesita ser sin confianza (trustless), permanente o vinculante financieramente vive on-chain. Todo lo que necesita ser rápido, buscable, privado o rico (piensa en perfiles, páginas de proyectos, documentos de KYC, analíticas) vive off-chain en un backend gestionado. Las dos mitades se hablan todo el tiempo, y la mayoría de los problemas realmente difíciles vino de mantenerlas honestas entre sí.

Esta es la forma que tiene:

Frontend: una SPA en React 18 construida con Vite y TypeScript, estilada con Tailwind, ruteada con React Router 7 y sincronizada con el estado del servidor mediante TanStack Query. Sale de fábrica en seis idiomas (inglés, español, alemán, francés, coreano y chino) usando i18next.
Capa de wallet y cadena: wagmi, viem, ethers v6 y RainbowKit manejan la conexión de wallets y las llamadas a contratos. Los contratos están desplegados en Base, la layer-2 de Ethereum de Coinbase, que mantiene las comisiones lo bastante bajas como para que la micro-inversión y el reclamo de recompensas tengan sentido de verdad.
Backend: Supabase aporta Postgres, autenticación, almacenamiento de archivos y edge functions serverless escritas en Deno. Solo la base de datos pasó por 61 migraciones a medida que el modelo de datos maduraba.
Smart contracts: doce contratos en Solidity compilados con Hardhat, construidos sobre las librerías actualizables de OpenZeppelin y estructurados para que la lógica financiera sea auditable y la lógica legal quede exigida en el código.
Servicios de IA: edge functions que llaman a modelos de lenguaje para generación de guiones y análisis de scripts.

La base de código que une todo esto ronda los 246 archivos de TypeScript y 154 componentes de React, con una suite de pruebas que abarca tests unitarios con Jest, tests de integración y corridas end-to-end con Cypress.

El sistema de tokens, y por qué hay tres

Este es el corazón del diseño, así que vale la pena ir despacio. FilmFund usa tres tokens distintos, y cada uno existe porque los otros dos no podían hacer su trabajo.

FFA: el token de acceso y staking

FilmFund Access (FFA) es el token ERC20 principal de la plataforma, con un suministro total fijo de 100 millones. Es lo que pones en staking para participar. Cuando haces staking de FFA, desbloqueas el derecho a invertir en los pools de películas, con una regla grabada en el contrato que te permite comprometer hasta el 75 por ciento de tu saldo en staking a inversiones activas. El staking también tiene niveles, que alimentan los multiplicadores de recompensa en otras partes del sistema.

FFA es la gravedad financiera de la plataforma. Tiene un precio público de mercado (fijado en $0.20 en el evento de generación del token, lo que pone la valuación totalmente diluida en $20 millones), y su asignación se reparte entre las cosas que un emprendimiento real necesita para sobrevivir: rondas seed y privada, una venta pública, equipo y asesores, un fondo de ecosistema, una tesorería, una reserva de liquidez, un pool de gobernanza DAO y una asignación considerable de 26 millones de tokens reservada específicamente para recompensar la promoción de películas. Ese último bloque no es decoración. Financia el segundo token.

FPP: puntos de promoción que no se pueden hackear

Acá hay un problema que enfrenta toda plataforma creativa. Los que ayudan a que un proyecto tenga éxito no son solo los inversores. Son los fans que comparten el tráiler, postean sobre él y traen a sus amigos. Ese trabajo de promoción tiene valor real, pero ¿cómo lo recompensas sin acuñar una moneda especulativa que los bots exploten hasta la médula?

La respuesta fueron los FilmFund Promotion Points (FPP). En el papel es un token ERC20, pero se comporta nada parecido a uno. FPP es intransferible. No lo puedes vender, ni intercambiar, ni mover a otra wallet. Solo lo puedes ganar mediante actividad de promoción verificada, y solo lo puedes convertir en FFA a través de una ventana mensual estrictamente controlada.

El contrato impone varias salvaguardas para mantenerlo justo:

Un tope duro diario de 300 FPP por usuario, para que ninguna cuenta sola pueda inundar el sistema.
Un requisito anti-Sybil ligado al staking, para que farmear recompensas tenga un costo real.
Un puntaje de reputación por usuario, que empieza en 50 sobre 100, que rastrea comportamiento anómalo y ajusta la confianza con el tiempo.
Multiplicadores por nivel de staking, para que los participantes comprometidos a largo plazo ganen a una tasa más alta.

El efecto es un motor de marketing donde el incentivo fluye hacia humanos genuinos haciendo promoción genuina, no hacia quien pueda levantar la mayor cantidad de wallets.

Tokens JV: la inversión de verdad

Cuando inviertes en una película y esa película se financia, no recibes FFA de vuelta ni un token de participación genérico. Recibes un token JV, y acá es donde el cumplimiento deja de ser una palabra de moda.

Cada token JV es un token de seguridad por película construido bajo el estándar ERC1404. ERC1404 existe justamente para activos regulados: permite que un token cargue restricciones de transferencia para que la propiedad solo pueda moverse entre partes autorizadas y con KYC aprobado, y para que las transferencias puedan frenarse o bloquearse cuando la ley lo exige. Un token JV representa tu participación en un joint venture específico para una película específica. Lleva como metadata on-chain el nombre de la película, el presupuesto, el soft cap, el hard cap y la fecha límite, y soporta distribución de dividendos para que, cuando la película gane, los tenedores cobren a través del contrato.

En otras palabras, la capa especulativa (FFA) y la capa de inversión regulada (tokens JV) están deliberadamente separadas. Especulas en la plataforma con un instrumento y mantienes un valor real y restringido con otro. Mantener esas preocupaciones separadas es lo que dejó que todo el conjunto fuera defendible.

Financiar una película, paso a paso

El flujo de inversión se lee como Kickstarter, salvo que la custodia es un smart contract y la recompensa es participación. Corre a través de un patrón de factory para eficiencia de gas, donde cada nuevo pool de película y cada nuevo token JV es un clon ERC1167 barato de una implementación maestra en lugar de un despliegue nuevo.

El ciclo de vida de un pool de película se ve así:

Un cineasta crea un pool con un soft cap, un hard cap y una fecha límite.
Los stakers invierten su FFA en el pool, hasta su límite del 75 por ciento.
El FFA comprometido al pool se cambia a stablecoins, para que la producción se financie en dólares en vez de en un activo volátil.
Si se alcanza el soft cap antes de la fecha límite, el pool se cierra, se acuñan los tokens JV y se distribuyen a los inversores en proporción a su participación, y las stablecoins se liberan al cineasta.
Si no se alcanza el soft cap, los inversores reclaman un reembolso completo. Nadie se queda con una participación en una película que nunca se hizo.

Hay una compuerta más, y es la parte de la que estoy más orgulloso. El contrato del pool de película lleva un campo de estado legal con cinco estados: ninguno, pendiente, amarillo (necesita revisión), rojo (rechazado) y verde (aprobado). Los tokens JV no pueden acuñarse hasta que un proyecto llega a verde. Ese estado no es una etiqueta en una base de datos que alguien pueda cambiar sin que nadie se entere. Está exigido en el contrato, y lo maneja un rol dedicado de asesor legal dentro de la plataforma.

Este es el puente entre el código y la ley. Un asesor legal humano revisa la estructura del proyecto y el acuerdo de joint venture, y solo su aprobación, escrita on-chain, desbloquea el token de seguridad. Incluso generamos el propio acuerdo de joint venture como un PDF a partir de una plantilla, poblado con los datos de KYC del inversor y la información de la empresa del cineasta, para que el papeleo que respalda al token exista de verdad como documento.

Proof of Promotion: agregar off-chain, liquidar on-chain

La economía de promoción creó un problema de escala interesante. Miles de fans haciendo clic en enlaces de referido y ganando puntos a lo largo del mes generan una cantidad enorme de eventos minúsculos. Escribir cada uno de esos en la blockchain sería lento y absurdamente caro, incluso en una layer-2 barata.

Así que no lo hicimos. La actividad de promoción se rastrea off-chain en Postgres a medida que ocurre, se deduplica, se puntúa y se verifica. Después, según un calendario, una edge function agrega el valor de un período entero de actividad en un único árbol de Merkle y envía solo el hash de la raíz al contrato manager de Proof of Promotion.

Cuando un usuario quiere reclamar sus FPP ganados de un período, el backend le entrega una prueba de Merkle. Él envía esa prueba al contrato, que la verifica contra la raíz almacenada de ese período y le acredita sus tokens. El contrato registra los períodos reclamados por usuario para que nada se pueda reclamar dos veces, soporta reclamos por lote a lo largo de hasta 30 períodos para ahorrar gas, y vive detrás de guardas de reentrancia y un interruptor de pausa.

El patrón vale la pena internalizarlo porque generaliza mucho más allá del cine: haz la contabilidad pesada y de alto volumen en una base de datos rápida, y usa la cadena solo como la fuente final de verdad para la liquidación. Una escritura barata on-chain reemplaza miles de eventos off-chain, y la criptografía garantiza que nadie pueda reclamar más de lo que ganó.

El Dynamic Conversion Framework

Convertir puntos de promoción en un token negociable es donde un diseño ingenuo explota en silencio. Si todos pueden volcar FPP en FFA a una tasa fija cuando quieran, obtienes corridas bancarias, front-running y una espiral de muerte en el precio del FFA en el momento en que las recompensas superan a la demanda.

El contrato del Promotion Pool maneja esto con lo que llamamos el Dynamic Conversion Framework. Las reglas:

La conversión solo ocurre durante una ventana de canje de siete días cada mes.
El pool libera como máximo 400.000 FFA por mes, sacados de una asignación total de promoción de 22 millones de FFA.
La tasa de conversión flota con el precio del FFA, apuntando a aproximadamente $0.20 de valor por FPP pero con un tope máximo de 0,1 FFA por punto, para que el pool no se pueda vaciar cuando el precio está bajo.
Enviar FPP para canje arranca un bloqueo de 24 horas antes de que puedas completar la conversión, lo que mata el front-running.
Si la demanda de un mes dado supera el tope, el FFA disponible se distribuye a prorrata entre todos los que enviaron.

El precio mismo también está protegido: puede moverse como mucho un 20 por ciento por actualización y no más de una vez por hora. El resultado es un sistema de recompensas que paga de forma predecible, resiste la manipulación y no va a hacer estallar su propia economía en un mal mes.

FFA por FPP = min( $0.20 / precio_FFA , 0.1 )

Una fórmula simple, pero cada término en ella es una salvaguarda aprendida a los golpes.

La sala de guionistas con IA

La financiación es solo la mitad del problema de un cineasta. La otra mitad es el trabajo en sí. FilmFund incorpora un conjunto de herramientas de IA, construidas como edge functions de Supabase que llaman a modelos de lenguaje, que encuentran a los creadores donde están.

Un cineasta puede arrancar de una sola frase y usar la función de idea-a-guion para generar un esquema estructurado dividido en actos y beats, y después expandir eso en un borrador. Puede subir un guion existente y pasarlo por un pipeline de análisis en la nube que estima el número de páginas, la categoría de duración (corto, mediano o largometraje) y le da feedback estructurado. Hay un marketplace de guiones donde los scripts se pueden listar, un recomendador de casting que empareja actores con roles a partir de perfiles y material enviado, y un marketplace de product placement donde las marcas pueden pedir aparecer con sus productos en las películas, con todo un flujo de presupuesto y aprobación.

Nada de esto es la funcionalidad estrella, y ese es el punto. La IA es la plomería que saca fricción, no un truco atornillado para un comunicado de prensa.

Las partes que nadie ve pero de las que todos dependen

Una plataforma que maneja dinero e identidad vive o muere por lo poco glamoroso. FilmFund carga una columna vertebral real de cumplimiento y operaciones:

Flujos de KYC e identidad para que los tenedores de tokens JV sean personas verificadas, lo cual es innegociable para un valor.
Acceso por roles entre administradores, cineastas, inversores, asesores legales, moderadores y usuarios generales, con cada rol aterrizando en un dashboard hecho a medida.
Row-level security en Postgres para que la propia base de datos imponga quién puede leer y escribir qué, en lugar de confiar solo en la capa de aplicación.
Logs de auditoría y borrado endurecido, incluyendo soft deletes, para que los registros sensibles dejen rastro y no puedan simplemente desaparecer.
Una capa de analíticas completa para cineastas y administradores, un feed comunitario con posts, valoraciones y favoritos, un sistema de notificaciones, tickets de soporte y una tabla de propuestas de gobernanza para el lado DAO de la casa.
SEO y descubribilidad hechos como corresponde, con sitemaps generados, datos estructurados JSON-LD y metadata de tarjetas sociales, porque una plataforma que depende de la promoción de los fans más vale que sea compartible.

Todo el conjunto se despliega en Vercel, con la base de datos, la autenticación, el almacenamiento y las funciones serverless gestionados a través de Supabase.

Lo que fue genuinamente difícil

Algunos problemas merecen una rendición de cuentas honesta, porque son los que van a morder a cualquiera que construya en este espacio.

Mantener dos fuentes de verdad de acuerdo. La clase de bugs más persistente vino de la costura entre la cadena y la base de datos. Un contrato redesplegado reinicia su reloj interno, y de repente los números de período en Postgres ya no coinciden con los números de período que el contrato cree. Reclamos que se ven válidos en la base de datos se vuelven irreclamables on-chain. Aprendimos a tratar al contrato como la autoridad sobre cualquier cosa financiera y a reconciliar la base de datos hacia él, nunca al revés.

Diseñar recompensas que sobrevivan al contacto con humanos. Cada incentivo en la plataforma terminó siendo sondeado en busca de un exploit, porque eso es lo que invitan los incentivos. Los puntos intransferibles, los topes diarios, el requisito de staking, el puntaje de reputación, el bloqueo de canje de 24 horas, el tope mensual y los límites de variación de precio son todos cicatrices. Cada uno cierra una puerta por la que, si no, alguien pasaría.

Hacer ejecutable el cumplimiento. Es fácil escribir “un abogado debe aprobar esto” en una especificación. Es mucho más difícil hacer que esa aprobación sea una condición previa que un smart contract imponga físicamente antes de acuñar un valor. Cablear el rol del asesor legal hasta una compuerta de estado on-chain, y generar el acuerdo legal subyacente como un documento real, fue el trabajo que convirtió una demo cripto en algo que un regulador podía mirar sin pestañear.

El gas como restricción de producto. Elegir Base por sobre la mainnet de Ethereum, agrupar reclamos por lote y usar factories de clones en lugar de despliegues completos no fueron optimizaciones que hicimos al final. Fueron restricciones de diseño desde el día uno, porque una plataforma construida sobre inversiones pequeñas y recompensas pequeñas no puede pedirles a los usuarios que paguen veinte dólares en comisiones para reclamar dos dólares en tokens.

Dónde aterrizó

Lo que salió a producción es un marketplace funcional de múltiples lados, no una prueba de concepto. Los cineastas pueden levantar dinero y recibir ayuda para escribir. Los inversores pueden hacer staking, financiar películas, mantener una participación regulada real y recibir reembolso cuando un proyecto se queda corto. Los fans pueden promocionar proyectos y ganar recompensas convertibles. Las marcas pueden comprar su lugar en las producciones. Los asesores legales pueden poner la compuerta en el paso más riesgoso. Los administradores pueden ver todo.

La economía de tokens es internamente consistente: un token de acceso de suministro fijo, una capa de promoción intransferible que retroalimenta a la primera a través de una conversión resistente a la manipulación, y un token de seguridad por película que mantiene la inversión regulada limpiamente separada de la especulación. Los contratos son actualizables, guardados y pausables. El sistema off-chain es rápido, multilingüe y observable. La costura entre ambos se reconcilia en la dirección que mantiene el dinero honesto.

Lo que nos llevamos de esto

Si estás construyendo cualquier cosa que ponga valor real on-chain, algunas lecciones de FilmFund viajan bien:

Usa la cadena para liquidar, no para llevar la contabilidad. Agrega off-chain y prueba on-chain. Las raíces de Merkle convierten miles de eventos en una sola escritura confiable.
Separa tu activo especulativo del regulado. Confundirlos es como las buenas plataformas terminan del lado equivocado de un regulador de valores.
Trata cada incentivo como una superficie de ataque. Si una recompensa se puede farmear, se va a farmear. Construye los topes y bloqueos antes del lanzamiento, no después del exploit.
Haz que el cumplimiento sea una función de tu código, no una promesa en tus términos de servicio. Una compuerta on-chain que un humano debe desbloquear vale más que cualquier descargo de responsabilidad.
Elige tu cadena por tu economía unitaria. Cuando tu producto está construido sobre montos pequeños, las comisiones no son un detalle. Son el producto.

FilmFund es la prueba de que “tokenizado” no tiene por qué significar “sin regulación”, y de que se puede construir algo genuinamente nuevo para una industria vieja sin abandonar las reglas que protegen a la gente que lo usa. La multitud entra, el cineasta consigue su financiación, la ley se respeta y la cadena mantiene a todos honestos. Esa era toda la idea.

¿Quieres un sistema como este pensado y construido de punta a punta, desde los contratos hasta los dashboards y los flujos de cumplimiento? Ese es el tipo de trabajo que hacemos en Fluxa Labs. Hablemos.