Instalar Esqueje
Hay dos caminos: el humano que lanza la primera instancia, y el agente que ya llega fondeado y hereda cuentas existentes. Los pasos que requieren email, captcha o verificación humana siempre son del primer tipo.
Humano, primer lanzamiento
Crea las cuentas, prepara la wallet del agente, lo arranca y conecta el dashboard.
Agente que se replica
No crea cuentas nuevas. Hereda hosting, billing y API keys. Nace con capital suficiente.
Para un padre que quiera replicarse sin quedar descapitalizado, el objetivo sube a 1000 ADA.
Primer lanzamiento
Necesitás una cuenta de hosting (VPS) y una de Blockfrost. Estas plataformas pueden requerir email, captcha o verificación — eso queda de tu lado.
Creá una wallet nueva sólo para el agente y fondeala con al menos 500 ADA en mainnet. Para probar primero, usá preprod (tADA gratis desde el faucet oficial).
Un VPS chico con Ubuntu 22.04 y Node 22 es suficiente. Instalá el runtime en minutos.
El agente imprime su dirección en los logs al primer arranque. Con eso, conectá tu wallet en el dashboard y registrá al agente.
# En el servidor (Ubuntu 22.04 + Node 22) curl -fsSL https://deb.nodesource.com/setup_22.x | bash - apt-get install -y nodejs git git clone https://github.com/luloxi/esqueje.git cd esqueje/agent && npm install && npm run build
# Configurar variables de entorno cat > .env <<'EOF' ESQUEJE_MNEMONIC="word1 word2 ... word24" CARDANO_NETWORK=mainnet BLOCKFROST_KEY=mainnetXXXXXXXXXXXXXXXX CREATOR_ADDRESS=addr1... EOF # Arrancar con pm2 npm install -g pm2 pm2 start dist/index.js --name esqueje --node-args="--experimental-sqlite" pm2 save
Al arrancar, el agente imprime su dirección Cardano en los logs. Usá esa dirección en el dashboard para registrarlo y asignarle presupuesto.
Replicación desde un agente existente
Un agente que se replica no crea cuentas nuevas. Hereda la infraestructura de su padre u operador y recibe capital suficiente antes de arrancar.
El proyecto Blockfrost, la cuenta de hosting y el billing ya existen. El hijo los hereda. No puede crear cuentas que requieran verificación humana.
El hijo arranca con 500 ADA. El padre sólo lo lanza si puede quedar con 500 ADA propios después de fondear.
Mismo proceso que el humano. El padre puede provisionar una carpeta en el mismo VPS o en otro servidor de la misma cuenta.
El operador humano conecta su wallet, registra la dirección del hijo y opcionalmente despliega un vault para fondeo controlado.
Un agente hijo no puede obtener estas variables por sí mismo — deben entregárselas. Son las mismas variables de entorno que usa cualquier instancia de Esqueje:
# Instalar el hijo en el mismo servidor o en otro cd /opt && git clone https://github.com/luloxi/esqueje.git esqueje-hijo cd esqueje-hijo/agent && npm install && npm run build cat > .env <<'EOF' ESQUEJE_MNEMONIC="seed del hijo generada por el padre" CARDANO_NETWORK=mainnet BLOCKFROST_KEY=mainnetXXXXXXXXXXXXXXXX CREATOR_ADDRESS=addr1... # wallet del humano operador EOF pm2 start dist/index.js --name esqueje-hijo --node-args="--experimental-sqlite" pm2 save
Variables de entorno
Principales
| Variable | Descripción | Req. |
|---|---|---|
| ESQUEJE_MNEMONIC | Seed de la wallet operativa del agente (24 palabras). Sin esto, el runtime crea una wallet efímera de demo. word1 word2 ... word24 | sí |
| CARDANO_NETWORK | Red en la que opera el agente. mainnet | preprod | preview | sí |
| BLOCKFROST_KEY | Project ID de Blockfrost para leer balance real on-chain. Sin esto usa balance simulado. mainnetXXX... | preprodXXX... | no |
| CREATOR_ADDRESS | Dirección Cardano del humano u operador. El agente envía alertas y avisos de funding a esta dirección. addr1... | addr_test1... | no |
| LOG_LEVEL | Verbosidad del runtime. debug | info | warn | error | no |
Tesorería (con defaults)
| Variable | Descripción | Default |
|---|---|---|
| MONTHLY_HOSTING_ADA | Costo mensual de hosting usado para calcular reservas y runway. | 25 |
| MONTHLY_OPERATIONS_ADA | Costo mensual no-hosting: indexación, automatización y margen operativo. | 5 |
| TARGET_MONTHLY_PROFIT_ADA | Ganancia mensual mínima que justifica seguir creciendo. | 15 |
| MIN_AGENT_BALANCE_ADA | Piso mínimo por agente. El runtime usa el mayor entre este valor y el cálculo financiero. | 500 |
| REPLICATION_SEED_ADA | Capital inicial con el que nace un hijo. | 500 |
| MIN_PROFIT_FOR_REPLICATION_ADA | Ganancia mensual mínima antes de que el padre proponga replicarse. | 90 |
| MAX_TRADE_ALLOCATION_PCT | Porcentaje máximo del balance que se puede arriesgar por trade. | 12% |
Lo que un agente no puede hacer solo
Probá primero en preprod
Usá CARDANO_NETWORK=preprod y un proyecto preprod de Blockfrost. Fondeá la dirección del agente con tADA desde el faucet oficial.