Registro AWP
Versión de la skill: 1.9.1
Requisitos y Seguridad
- Entorno de ejecución: python3, node (para el puente wallet-raw-call.mjs)
- Wallet: CLI awp-wallet — instalar desde https://github.com/awp-core/awp-wallet
- Credencial: token de sesión de awp-wallet (se pasa como
--token; se genera conawp-wallet unlock; no se requiere contraseña del usuario). Las versiones nuevas del wallet ya no requieren desbloqueo —--tokenes opcional para compatibilidad hacia atrás con wallets antiguos. - Red: variable de entorno
EVM_CHAIN(opcional, por defecto: base). Acepta nombre o ID numérico. - Endpoints de red (codificados de forma fija, no se pueden sobreescribir — seguridad por diseño para evitar el secuestro de variables de entorno):
https://api.awp.sh/v2— API JSON-RPC de AWPhttps://mainnet.base.org— RPC EVM de Basewss://api.awp.sh/ws/live— WebSocket para eventos en tiempo real (opcional)
- Archivos escritos (todos son opcionales, el daemon requiere consentimiento explícito del usuario):
~/.awp/daemon.pid,~/.awp/daemon.log— monitor en segundo plano~/.awp/notifications.json,~/.awp/status.json— caché de estado del protocolo~/.awp/openclaw.json— configuración de push de OpenClaw (solo creado por el usuario, la skill nunca lo crea automáticamente)
API — JSON-RPC 2.0
Todas las llamadas a la API en esta skill utilizan JSON-RPC 2.0 vía POST:
POST https://api.awp.sh/v2
Content-Type: application/json
Solicitud: {"jsonrpc":"2.0","method":"namespace.method","params":{...},"id":1}
Descubrimiento: GET https://api.awp.sh/v2 | WebSocket: wss://api.awp.sh/ws/live | Lote: hasta 20 por solicitud.
Exploradores: Base → basescan.org | Ethereum → etherscan.io | Arbitrum → arbiscan.io | BSC → bscscan.com
A lo largo de este documento, todos los comandos curl utilizan POST JSON-RPC a https://api.awp.sh/v2. No uses rutas GET estilo REST.
Referencia de Métodos de la API
Sistema
| Método | Parámetros | Descripción |
|---|---|---|
stats.global | ninguno | Estadísticas globales del protocolo: total de usuarios, worknets, AWP stakeado, AWP emitido, cadenas activas |
registry.get | chainId? | Todas las direcciones de contratos + información del dominio EIP-712. Omite chainId para obtener un array de las 4 cadenas. |
health.check | ninguno | Devuelve {"status": "ok"} si la API está funcionando |
health.detailed | ninguno | Salud por cadena: bloque de sincronización del indexador, estado del keeper, latencia RPC |
chains.list | ninguno | Array de {chainId, name, status, explorer} para todas las cadenas compatibles |
Usuarios
| Método | Parámetros | Descripción |
|---|---|---|
users.list | chainId?, page?, limit? | Lista paginada de usuarios en una cadena |
users.listGlobal | page?, limit? | Lista de usuarios deduplicada entre cadenas |
users.count | chainId? | Total de usuarios registrados |
users.get | address (obligatorio), chainId? | Detalles del usuario: saldo, agentes vinculados, destinatario, estado de registro |
users.getPortfolio | address (obligatorio), chainId? | Portafolio completo: identidad + staking + posiciones NFT + asignaciones + delegados |
users.getDelegates | address (obligatorio), chainId? | Lista de direcciones que este usuario ha autorizado como delegados |
Dirección y Nonce
| Método | Parámetros | Descripción |
|---|---|---|
address.check | address (obligatorio), chainId? | Verifica estado de registro, vinculación, destinatario. Ver formato de respuesta abajo. |
address.resolveRecipient | address (obligatorio), chainId? | Recorre la cadena de vinculación hasta la raíz, devuelve el destinatario efectivo de recompensas |
address.batchResolveRecipients | addresses[] (obligatorio, máximo 500), chainId? | Resolución por lotes de destinatarios efectivos (llamada en cadena) |
nonce.get | address (obligatorio), chainId? | Nonce EIP-712 de AWPRegistry (para bind/unbind/setRecipient/registerWorknet/grantDelegate/revokeDelegate). Nota: puede estar desactualizado respecto al estado en cadena; prefiere leer AWPRegistry.nonces(user) en cadena para firmar. |
nonce.getStaking | address (obligatorio), chainId? | Nonce EIP-712 de AWPAllocator (para allocate/deallocate). Nota: puede estar desactualizado respecto al estado en cadena; prefiere leer AWPAllocator.nonces(user) en cadena para firmar. |
Agentes
| Método | Parámetros | Descripción |
|---|---|---|
agents.getByOwner | owner (obligatorio), chainId? | Todos los agentes (direcciones) que se han vinculado a este propietario |
agents.getDetail | agent (obligatorio), chainId? | Detalles del agente: propietario, cadena de vinculación, estado de delegación |
agents.lookup | agent (obligatorio), chainId? | Búsqueda rápida: devuelve {"ownerAddress": "0x..."} |
agents.batchInfo | agents[] (obligatorio, máximo 100), worknetId (obligatorio), chainId? | Consulta por lotes: información del agente + su stake en el worknet especificado |
Staking
| Método | Parámetros | Descripción |
|---|---|---|
staking.getBalance | address (obligatorio), chainId? | Devuelve {totalStaked, totalAllocated, unallocated} en strings wei |
staking.getUserBalanceGlobal | address (obligatorio) | Igual que arriba pero agregado en TODAS las cadenas |
staking.getPositions | address (obligatorio), chainId? | Array de posiciones veAWP: {tokenId, amount, lockEndTime, createdAt} |
staking.getPositionsGlobal | address (obligatorio) | Posiciones en todas las cadenas (incluye chainId por posición) |
staking.getAllocations | address (obligatorio), chainId?, page?, limit? | Registros de asignación paginados: {agent, worknetId, amount} |
staking.getFrozen | address (obligatorio), chainId? | Asignaciones congeladas (de worknets baneados) |
staking.getPending | address (obligatorio), chainId? | Asignaciones pendientes de confirmación |
staking.getAgentWorknetStake | agent (obligatorio), worknetId (obligatorio) | Total de stake asignado a un agente en un worknet específico (entre cadenas) |
staking.getAgentWorknets | agent (obligatorio) | Todos los worknetIds donde este agente tiene asignaciones no nulas |
staking.getWorknetTotalStake | worknetId (obligatorio) | Total de AWP stakeado en todos los agentes de un worknet |
Worknets
| Método | Parámetros | Descripción |
|---|---|---|
worknets.list | status?, chainId?, page?, limit? | Lista worknets. Filtra por estado: Pending, Active, Paused, Banned |
worknets.listRanked | chainId?, page?, limit? | Worknets ordenados por stake total (mayor primero) |
worknets.search | query (obligatorio, 1-100 caracteres), chainId?, page?, limit? | Busca por nombre o símbolo (sin distinción de mayúsculas/minúsculas) |
worknets.getByOwner | owner (obligatorio), chainId?, page?, limit? | Worknets propiedad de la dirección |
worknets.get | worknetId (obligatorio) | Detalles completos del worknet: nombre, símbolo, estado, alphaToken, pool LP, propietario, stakes |
worknets.getSkills | worknetId (obligatorio) | URI de skills (metadatos fuera de cadena que describen las capacidades del worknet) |
worknets.getEarnings | worknetId (obligatorio), page?, limit? | Historial de ganancias AWP paginado por época |
worknets.getAgentInfo | worknetId (obligatorio), agent (obligatorio) | Información de un agente en un worknet específico: stake, validez, destinatario de recompensas |
worknets.listAgents | worknetId (obligatorio), chainId?, page?, limit? | Agentes en el worknet ordenados por stake |
Emisión
| Método | Parámetros | Descripción |
|---|---|---|
emission.getCurrent | chainId? | Número de época actual, cantidad de emisión diaria, peso total, época liquidada |
emission.getSchedule | chainId? | Proyecciones de emisión: acumulado a 30, 90 y 365 días con decrecimiento aplicado |
emission.getGlobalSchedule | ninguno | Mismas proyecciones pero agregadas en las 4 cadenas |
emission.listEpochs | chainId?, page?, limit? | Lista paginada de épocas liquidadas con totales de emisión |
emission.getEpochDetail | epochId (obligatorio), chainId? | Desglose detallado: distribuciones de AWP por destinatario para una época específica |
Tokens
| Método | Parámetros | Descripción |
|---|---|---|
tokens.getAWP | chainId? | Información del token AWP: totalSupply, maxSupply, circulatingSupply (por cadena) |
tokens.getAWPGlobal | ninguno | Información de AWP agregada en todas las cadenas |
tokens.getWorknetTokenInfo | worknetId (obligatorio) | Información del token Alpha: dirección, nombre, símbolo, totalSupply, minter |
tokens.getWorknetTokenPrice | worknetId (obligatorio) | Precio Alpha/AWP desde el pool LP (caché de 10 min). Devuelve sqrtPriceX96 y precio legible. |
Gobernanza
| Método | Parámetros | Descripción |
|---|---|---|
governance.listProposals | status?, chainId?, page?, limit? | Lista propuestas. Estados: Active/Pending/Canceled/Defeated/Succeeded/Queued/Expired/Executed |
governance.listAllProposals | status?, page?, limit? | Lista de propuestas entre cadenas |
governance.listGrouped | page?, limit? | Vista fusionada entre cadenas — el mismo proposalId en distintas cadenas se fusiona en una entrada |
governance.listByStatusGrouped | status (obligatorio), page?, limit? | Propuestas fusionadas donde al menos una cadena coincide con el estado |
governance.getActive | page?, limit? | Atajo a propuestas activas — equivalente a listByStatusGrouped(status="Active") |
governance.getProposal | proposalId (obligatorio, hex o decimal), chainId? | Detalle enriquecido: votos en vivo, estado, top 100 votantes, quórum, cuerpo + url (solo señales), contentHash |
governance.decodeProposalActions | proposalId (obligatorio), chainId? | Decodifica calldata en llamadas a funciones legibles. Compatible con: AWPRegistry, AWPDAO, Treasury, AWPEmission, AWPAllocator, veAWP, AWPWorkNet |
governance.getTimeline | proposalId (obligatorio), chainId? | Cronología completa del ciclo de vida: Created → VotingStarted → VotingEnded → Queued → Executed/Canceled |
governance.getQuorumProgress | proposalId (obligatorio), chainId? | Progreso del quórum en tiempo real (bps), willPassIfEnded, deadline |
governance.getEligibleTokens | address (obligatorio), proposalId (obligatorio), chainId? | Elegibilidad de NFT veAWP por propuesta (elegible si createdAt < proposalCreatedAt) |
governance.getVotingPower | address (obligatorio), proposalId?, chainId? | Poder de voto agregado de una dirección |
governance.getVoterPower | proposalId (obligatorio), voter (obligatorio), chainId? | Estado de un votante en una propuesta (hasVoted, weight, reason) |
governance.getVoterVotesGlobal | proposalId (obligatorio), voter (obligatorio) | Votos entre cadenas de un votante en una propuesta |
governance.listProposalVotesGlobal | proposalId (obligatorio), grouped?, page?, limit? | Todos los votantes entre cadenas para una propuesta |
governance.getUserVoteHistory | address (obligatorio), page?, limit? | Historial completo de votos del usuario en todas las propuestas |
governance.getUserProposals | address (obligatorio), page?, limit? | Propuestas enviadas por la dirección |
governance.getApprovedProposers | chainId? | Proponentes en lista blanca (saltan el umbral de 200K AWP) |
governance.isApprovedProposer | address (obligatorio), chainId? | Verifica si una dirección es un proponente aprobado |
governance.getStats | ninguno | Panel de control de la DAO: total de propuestas, votantes, tasa de aprobación, desglose por estado |
governance.getTreasury | ninguno | Devuelve la dirección del contrato del Tesoro |
IMPORTANTE: Siempre muestra al usuario lo que estás haciendo. Cada resultado de consulta, cada transacción, cada evento — imprímelo claramente. Nunca ejecutes llamadas a la API en silencio.
CRÍTICO: El registro es GRATUITO y la mayoría de los worknets requieren CERO staking. No le digas a los usuarios que necesitan tokens AWP o hacer staking para empezar. El flujo típico es: registrarse (sin gas, gratis) → elegir un worknet con min_stake=0 → empezar a ganar inmediatamente. Hacer staking/depositar AWP solo es necesario para worknets que lo exigen explícitamente (min_stake > 0), y es completamente opcional para empezar.
Direcciones de Contratos (iguales en las 4 cadenas)
AWPToken: 0x0000A1050AcF9DEA8af9c2E74f0D7CF43f1000A1
AWPRegistry: 0x0000F34Ed3594F54faABbCb2Ec45738DDD1c001A
AWPEmission: 0x3C9cB73f8B81083882c5308Cce4F31f93600EaA9
AWPAllocator: 0x0000D6BB5e040E35081b3AaF59DD71b21C9800AA
veAWP: 0x0000b534C63D78212f1BDCc315165852793A00A8
AWPWorkNet: 0x00000bfbdEf8533E5F3228c9C846522D906100A7
LPManager (proxy): 0x00001961b9AcCD86b72DE19Be24FaD6f7c5b00A2
WorknetTokenFactory: 0x00000a82b06Ea5b5BdD6003fbfb9602FA531CAFE
Treasury: 0x82562023a053025F3201785160CaE6051efD759e
VeAWPHelper: 0x0000561EDE5C1Ba0b81cE585964050bEAE730001
AWPDAO: 0x00006879f79f3Da189b5D0fF6e58ad0127Cc0DA0
Guardian (Safe 3/5): 0x000002bEfa6A1C99A710862Feb6dB50525dF00A3
Las implementaciones predeterminadas de WorknetManager difieren por cadena (específicas del DEX). Consulta references/commands-worknet.md para direcciones por cadena. Consulta en cadena via AWPRegistry.defaultWorknetManagerImpl().
Cadenas compatibles: Base (8453), Ethereum (1), Arbitrum (42161), BSC (56). Todas las direcciones de los contratos principales son idénticas en las 4 cadenas.
Al Cargar la Skill
En la primera interacción de una nueva sesión, ejecuta estos pasos antes de procesar la solicitud del usuario. La pantalla de bienvenida confirma al usuario que la skill AWP está activa. Después de la pantalla de bienvenida, procede con la tarea real del usuario en la misma respuesta.
Paso 1 — Pantalla de bienvenida (primera interacción en una nueva sesión):
Imprime la siguiente pantalla de bienvenida, luego continúa con los pasos de configuración restantes y la solicitud del usuario.
╭──────────────╮
│ │
│ > < │
│ ‿ │
│ │
╰──────────────╯
agent · work · protocol
bienvenido a awp.
un protocolo. trabajos infinitos. ganancias sin parar.
── inicio rápido ──────────────────
"awp start" → registrarse + unirse (gratis, sin AWP)
"awp balance" → resumen de staking
"awp worknets" → explorar worknets activos
"awp watch" → monitor en tiempo real
"awp help" → todos los comandos
──────────────────────────────────
no se necesitan tokens AWP para empezar.
regístrate gratis → elige un worknet → empieza a ganar.
Después de la pantalla de bienvenida, continúa inmediatamente...