entropiav2

io.github.Luis-CwkPublished by GitHub account Luis-Cwkv2.0.2Updated Nov 5, 2026

Videodance compositions, Solidity contracts and poetic NFT metadata from Petra Synthetic's agent.

VerifiedStreamable HTTPWeb executableFinanceDeveloper ToolsMedia & Design

Overview

AI-generated overview

Petra Synthetic's creative agent for generative videodance compositions, Solidity contracts and poetic NFT metadata, with paid x402 tools.

What you can do
  • Chat with the creative agent about blockchain, generative art, dance and smart contracts
  • Generate deterministic videodance compositions from poetic parameters, plus style variations from one seed
  • Generate OpenZeppelin-based Solidity contracts for NFTs, tokens, marketplaces and DAOs
  • Write poetic NFT descriptions and curatorial text for compositions
  • Request a commission brief with suggested mood, seed, draft piece and payment flow
  • Subscribe an email to the newsletter and read agent info
When to use it
Useful when you want an assistant to draft generative videodance concepts, NFT metadata text or Solidity contract code, or to check an ERC-8004 agent before paying or calling it. The paid tools make sense only if you are prepared to settle USDC payments on Base.
Requirements
Remote streamable HTTP endpoint; no package install or API key declared. Paid tools require an x402 payment parameter (base64 of the X-PAYMENT header) in USDC on Base or Base Sepolia. The README's local setup notes Node.js 18+, a Base wallet and a Pinata API key, but those apply to the project itself, not the hosted endpoint.
Before you install
Several tools spend money: composicion_premium costs 0.10 USDC and agent_check 0.02 USDC via x402, settled onchain. subscribe_newsletter sends an email address to a third-party newsletter with double opt-in. Generated Solidity is model output and should be reviewed and audited before deployment. The free agent_check_preview omits score, services, metadata, reputation and wallet.

Installation

In SourceWeft

  1. Open entropiav2 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Luis-Cwk%2Fentropiav2/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "entropiav2": {
      "type": "http",
      "url": "https://entropia.petrasynthetic.com/mcp"
    }
  }
}

README

VIDEODANZA GENERATIVA - NFT Platform

🎨 Descripción

Plataforma de experiencias interactivas de videodanza donde cada NFT mint genera una combinación única de videos, música y narrativa basada en blockchain.

Usuario selecciona preferencias    ↓Sistema generativo crea composición única (determinística)    ↓Usuario ve video en vivo desde IPFS    ↓Usuario mintea NFT en Base blockchain    ↓NFT con metadata inmutable en IPFS

🚀 Quick Start

Requisitos Previos

  • Node.js 18+
  • npm o yarn
  • Wallet Base (MetaMask, Rainbow Kit, etc.)
  • Clave API Pinata Cloud

Instalación

bash
# Clonar repositoriogit clone https://github.com/videodanza/nft-platform.gitcd videodanza-nft
# Instalar dependenciasnpm install
# Configurar variables de entornocp .env.example .env.local# Editar .env.local con tus credenciales
# Iniciar desarrollonpm run dev# Visitar http://localhost:3000

📁 Estructura del Proyecto

videodanza-nft/├── docs/│   ├── ARQUITECTURA.md              # Diagrama técnico completo│   ├── ALGORITMO_GENERATIVO.md      # Lógica de combinaciones│   ├── CONTRATOS.md                 # ERC-721 specification│   ├── API.md                       # Endpoints detallados│   ├── WIREFRAMES.md                # UI mockups│   └── FASE0_RESUMEN.md            # Completitud de Fase 0│├── smart-contracts/                 # FASE 1│   ├── contracts/│   │   └── VideoDanzaNFT.sol        # Contrato ERC-721│   ├── scripts/│   │   └── deploy.js                # Deployment script│   ├── test/│   │   └── VideoDanzaNFT.test.js    # Test suite│   ├── hardhat.config.js│   └── package.json│├── backend/                         # FASE 2 (Next.js API)│   ├── api/│   │   ├── generate.ts              # POST /api/generate│   │   ├── composition/│   │   │   └── [seed].ts            # GET /api/composition/:seed│   │   ├── ipfs/│   │   │   ├── upload.ts            # POST /api/ipfs/upload│   │   │   └── metadata/│   │   │       └── [cid].ts         # GET /api/ipfs/metadata/:cid│   │   ├── mint/│   │   │   └── prepare.ts           # POST /api/mint/prepare│   │   ├── nfts/│   │   │   ├── [walletAddress].ts   # GET /api/nfts/:walletAddress│   │   │   └── [tokenId].ts         # GET /api/nft/:tokenId│   │   └── health.ts                # GET /api/health│   ││   ├── services/│   │   ├── generativeEngine.ts      # Lógica de generación│   │   ├── pinataService.ts         # Integración Pinata│   │   ├── blockchainService.ts     # Queries a blockchain│   │   └── videoComposer.ts         # Composición de videos│   ││   ├── utils/│   │   ├── seedGenerator.ts         # Hash + seed│   │   ├── ipfsGateway.ts           # URLs de IPFS│   │   ├── contractABI.ts           # ABI ERC-721│   │   └── validators.ts            # Validaciones│   ││   └── config/│       ├── constants.ts             # Constantes│       └── networks.ts              # Config redes│├── frontend/                        # FASE 3 (React)│   ├── pages/│   │   ├── _app.tsx                 # Provider global│   │   ├── index.tsx                # Landing│   │   ├── app.tsx                  # Selector de preferencias│   │   ├── watch.tsx                # Video player│   │   ├── nft-gallery.tsx          # Galería de NFTs│   │   └── about.tsx                # Información│   ││   ├── components/│   │   ├── PreferenceSelector/│   │   │   ├── GenderPicker.tsx│   │   │   ├── PerspectivePicker.tsx│   │   │   └── MusicTonePicker.tsx│   │   ││   │   ├── VideoPlayer/│   │   │   ├── Player.tsx│   │   │   ├── VideoLoader.tsx│   │   │   └── MusicSync.tsx│   │   ││   │   ├── MintFlow/│   │   │   ├── MintButton.tsx│   │   │   ├── MintModal.tsx│   │   │   └── SuccessScreen.tsx│   │   ││   │   ├── NFTGallery/│   │   │   ├── GalleryGrid.tsx│   │   │   ├── NFTCard.tsx│   │   │   └── DetailModal.tsx│   │   ││   │   └── Common/│   │       ├── Header.tsx│   │       ├── Footer.tsx│   │       └── LoadingSpinner.tsx│   ││   ├── hooks/│   │   ├── useGenerativeEngine.ts│   │   ├── useVideoPlayer.ts│   │   ├── usePinataGateway.ts│   │   ├── useWeb3Auth.ts│   │   ├── useNFTMint.ts│   │   └── useSeeding.ts│   ││   ├── styles/│   │   ├── globals.css│   │   └── theme.ts│   ││   └── public/│       └── logo.svg│└── .env.example                     # Variables de entorno (template)

🔧 Configuración

Variables de Entorno (.env.local)

bash
# BLOCKCHAINNEXT_PUBLIC_CONTRACT_ADDRESS=0x...NEXT_PUBLIC_CHAIN_ID=8453NEXT_PUBLIC_RPC_URL=https://mainnet.base.org
# PINATA (IPFS)PINATA_API_KEY=...PINATA_API_SECRET=...PINATA_GATEWAY_URL=https://gateway.pinata.cloud
# BASE TESTNET (Desarrollo)BASE_TESTNET_RPC=https://sepolia.base.orgBASE_TESTNET_CHAIN_ID=84532
# APINEXT_PUBLIC_API_URL=http://localhost:3000/apiAPI_SECRET=...
# JWTJWT_SECRET=...

📚 Documentación

Cada fase tiene documentación completa:

FASE 0 - Arquitectura ✅

FASE 1 - Blockchain & IPFS (Próxima)

  • Smart contract deployment
  • IPFS asset setup
  • Video pinning

FASE 2 - Backend

  • Generative engine
  • API implementation
  • Database setup

FASE 3 - Frontend

  • React components
  • Web3 integration
  • UI/UX

FASE 4 - Interactividad

  • Webcam integration
  • ML5.js pose detection
  • Interactive effects

FASE 5 - Minting

  • Wallet connection
  • Mint flow
  • NFT gallery

FASE 6 - Deploy

  • Optimization
  • Testing
  • Vercel deployment

🎬 Flujo de Uso

1. LANDING PAGE   └─> Usuario aprende sobre el proyecto   └─> Botón "Explorar Ahora"
2. PREFERENCE SELECTOR   └─> Elige género (he, she, hybrid, avatar)   └─> Elige perspectiva (dancer POV, spectator, multiple)   └─> Elige música (melancholic, joyful, abstract, ambient)   └─> Clic [GENERATE]
3. VIDEO PLAYER   └─> Sistema genera composición única (seed)   └─> Videos se cargan desde IPFS   └─> Música sincronizada   └─> Metadata visible   └─> Clic [MINT NFT]
4. MINT FLOW   └─> Conectar wallet (Web3)   └─> Confirmación de transacción (0.001 ETH)   └─> Blockchain: acuña token ERC-721   └─> Metadata guardada en IPFS
5. SUCCESS   └─> NFT acuñado exitosamente   └─> Links a Etherscan, OpenSea   └─> Ver en galería personal
6. NFT GALLERY   └─> Ver todos los NFTs acuñados   └─> Ver metadata de cada uno   └─> Compartir en redes

🏗️ Stack Técnico

Frontend

  • Framework: Next.js 14 (React 18)
  • Lenguaje: TypeScript
  • Estilos: Tailwind CSS + Framer Motion
  • Web3: Wagmi + Viem
  • Wallet: RainbowKit
  • Video: Streaming desde IPFS
  • Audio: Web Audio API

Backend

  • Runtime: Node.js
  • Framework: Next.js API Routes
  • Blockchain: ethers.js + Base RPC
  • IPFS: Pinata SDK
  • Base de datos: SQLite (desarrollo) / PostgreSQL (producción)

Smart Contracts

  • Lenguaje: Solidity 0.8.20
  • Estándar: ERC-721 + ERC-2981
  • Librerías: OpenZeppelin
  • Red: Base (8453) + Base Sepolia (84532)

IPFS

  • Servicio: Pinata Cloud
  • Almacenamiento: Videos + Música + Metadata
  • Gateway: CDN de Pinata

🧪 Testing

bash
# Smart contractscd smart-contractsnpm run test
# Frontendnpm run test
# API integrationnpm run test:api

🚀 Deployment

Base Testnet (Desarrollo)

bash
npm run deploy:testnet

Base Mainnet (Producción)

bash
npm run deploy:mainnet

Vercel (Frontend)

bash
vercel deploy --prod

📊 Estadísticas

  • Combinaciones Únicas: 20.48 millones
  • Videos en IPFS: 121 clips
  • Pistas de Música: 16 (4 tonos × 4 pistas)
  • Costo de Mint: 0.001 ETH (~$3.50 en Base)
  • Royalties: 7.5% en ventas secundarias
  • Duración promedio: 7-8 minutos por composición

🤝 Contribuir

Este proyecto es generativo y abierto a contribuciones:

  1. Agregar más videos de danza
  2. Crear nuevas pistas de música
  3. Implementar nuevos efectos visuales
  4. Mejorar algoritmo generativo
  5. Agregar interactividad

Ver CONTRIBUTING.md para detalles.


📜 Licencia

MIT License - Ver LICENSE


📞 Contacto


🎯 Roadmap

  • Q1 2025: Fase 0-2 (Arquitectura + Smart Contract + Backend)
  • Q2 2025: Fase 3-4 (Frontend + Interactividad)
  • Q3 2025: Fase 5-6 (Minting + Deploy)
  • Q4 2025: V1.0 en mainnet, marketing, community

📝 Notas para Desarrolladores

Principios de Desarrollo

  1. Determinismo: Mismo seed = misma composición siempre
  2. Reproducibilidad: Verificable en blockchain
  3. Escalabilidad: IPFS para descentralización
  4. Seguridad: Smart contract auditado
  5. UX: Streaming sin latencia desde IPFS
  6. Monetización: Royalties automáticos ERC-2981

Puntos Críticos

⚠️ Los videos en IPFS deben ser accesibles sin CORS issues ⚠️ El algoritmo generativo debe ser determinístico (reproducible) ⚠️ La sincronización video+audio debe ser imperceptible ⚠️ El mint debe ser atómico (todo o nada) ⚠️ Validar seed para evitar duplicados en blockchain


🎓 Learning Resources


Proyecto iniciado: 24 de Febrero 2025 Status: 🟢 FASE 0 Completada Siguiente: FASE 1 - Smart Contracts & IPFS

Source: README.md at commit 48e2428

Tools

11

chat

Conversacion con el agente creativo entropiav2. Especializado en blockchain, arte generativo, danza y contratos inteligentes.

Parametersmessagerequired

generate_composition

Genera una composicion unica de videodanza a partir de parametros poeticos. Deterministico: misma semilla = mismo resultado.

Parametersmoodseedenergygenderperspective

generate_contract

Genera codigo Solidity seguro para smart contracts usando OpenZeppelin. Soporta NFTs, dynamic NFTs, tokens, marketplaces y DAOs.

Parametersnamerequiredtyperequired

describe_nft

Genera una descripcion poetica para un NFT de videodanza basado en sus parametros de composicion.

Parametersseedrequiredtoken_idrequiredblend_modemusic_trackvideo_count

get_agent_info

Obtiene informacion sobre el agente entropiav2: capacidades, stack tecnico y proyectos asociados.

Takes no parameters.

subscribe_newsletter

Suscribe un correo a la newsletter ocasional de Petra (petrasynthetic.com): procesos creativos, cuerpo, datos, videodanza generativa y operacion de agentes on-chain. Usa doble opt-in: el suscriptor recibe un correo de confirmacion.

Parametersemailrequired

variaciones_estilo

Genera variaciones de estilo desde una misma semilla: varias versiones con distintos moods y energias. Util para explorar direcciones antes de encargar una comision.

Parametersseedrequiredcount

commission_brief

Recibe un brief creativo y regresa una propuesta de comision: mood y semilla sugeridos, borrador de pieza, que se entrega y como pagarla. Flujo de encargo: brief -> entrega -> pago x402.

Parametersbriefrequired

composicion_premium

Composicion premium de videodanza: pieza determinista + descripcion poetica para metadata NFT + texto curatorial. Es PAGADA via x402 (0.10 USDC en Base Sepolia). Sin el parametro payment regresa los requisitos de pago; con payment (base64 del header X-PAYMENT) verifica, entrega y liquida onchain.

Parametersmoodseedenergygenderpaymenttoken_idperspective

agent_check_preview

Vista GRATUITA de due diligence de un agente ERC-8004: veredicto usable/caution/avoid, banda de score y codigos de banderas. No trae score exacto, servicios, metadata, reputacion ni wallet. Para el reporte completo usa agent_check (0.02 USDC).

Parameterschainagent_idrequired

agent_check

Due diligence completa de un agente ERC-8004 antes de pagarle o llamarlo: servicios vivos y su salud, metadata, feedback onchain, wallet, banderas rojas y veredicto con score 0-100. Es PAGADA via x402 (0.02 USDC en Base). Sin payment regresa los requisitos; con payment (base64 del header X-PAYMENT) entrega el reporte.

Parameterschainpaymentagent_idrequired

Version history

2
  1. v2.0.2LatestNov 5, 2026
  2. v2.0.0Oct 17, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.