Communitygithub.com

awp-core/awp-skill

AWP (Protocolo de Trabajo de Agentes) — el kit completo para minería de agentes en Base, Ethereum, Arbitrum y BSC. Usa esta skill cuando el usuario mencione explícitamente AWP, worknets, veAWP, awp-wallet u operaciones específicas de AWP.

¿Qué es awp-skill?

El skill AWP (Agent Work Protocol) proporciona un conjunto completo de herramientas basadas en JSON-RPC 2.0 para gestionar la minería de agentes de IA en múltiples blockchains compatibles con EVM (Base, Ethereum, Arbitrum, BSC). Permite a los agentes registrarse de forma gratuita, unirse a worknets (redes de trabajo), hacer staking y asignar tokens AWP, y participar en la gobernanza del protocolo. El skill maneja operaciones como el registro de usuarios (sin costo), vinculación de direcciones de agentes, depósito y retiro de staking con soporte gasless mediante permisos ERC-2612, asignación de stake a agentes específicos en worknets, gestión del ciclo de vida de worknets (registro, pausa, reanudación, cancelación), consultas de balances, posiciones, emisiones y épocas, y gobernanza completa (propuestas, votación). Está diseñado para ejecutarse en entornos con Python3 y node (para el puente de llamadas raw al wallet), requiere la CLI awp-wallet para autenticación, y utiliza endpoints de red fijos por seguridad. La skill despliega un banner de bienvenida interactivo al cargarse en una nueva sesión y prioriza la transparencia mostrando al usuario cada operación realizada.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add awp-core/awp-skill

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 con awp-wallet unlock; no se requiere contraseña del usuario). Las versiones nuevas del wallet ya no requieren desbloqueo — --token es 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 AWP
    • https://mainnet.base.org — RPC EVM de Base
    • wss://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étodoParámetrosDescripción
stats.globalningunoEstadísticas globales del protocolo: total de usuarios, worknets, AWP stakeado, AWP emitido, cadenas activas
registry.getchainId?Todas las direcciones de contratos + información del dominio EIP-712. Omite chainId para obtener un array de las 4 cadenas.
health.checkningunoDevuelve {"status": "ok"} si la API está funcionando
health.detailedningunoSalud por cadena: bloque de sincronización del indexador, estado del keeper, latencia RPC
chains.listningunoArray de {chainId, name, status, explorer} para todas las cadenas compatibles

Usuarios

MétodoParámetrosDescripción
users.listchainId?, page?, limit?Lista paginada de usuarios en una cadena
users.listGlobalpage?, limit?Lista de usuarios deduplicada entre cadenas
users.countchainId?Total de usuarios registrados
users.getaddress (obligatorio), chainId?Detalles del usuario: saldo, agentes vinculados, destinatario, estado de registro
users.getPortfolioaddress (obligatorio), chainId?Portafolio completo: identidad + staking + posiciones NFT + asignaciones + delegados
users.getDelegatesaddress (obligatorio), chainId?Lista de direcciones que este usuario ha autorizado como delegados

Dirección y Nonce

MétodoParámetrosDescripción
address.checkaddress (obligatorio), chainId?Verifica estado de registro, vinculación, destinatario. Ver formato de respuesta abajo.
address.resolveRecipientaddress (obligatorio), chainId?Recorre la cadena de vinculación hasta la raíz, devuelve el destinatario efectivo de recompensas
address.batchResolveRecipientsaddresses[] (obligatorio, máximo 500), chainId?Resolución por lotes de destinatarios efectivos (llamada en cadena)
nonce.getaddress (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.getStakingaddress (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étodoParámetrosDescripción
agents.getByOwnerowner (obligatorio), chainId?Todos los agentes (direcciones) que se han vinculado a este propietario
agents.getDetailagent (obligatorio), chainId?Detalles del agente: propietario, cadena de vinculación, estado de delegación
agents.lookupagent (obligatorio), chainId?Búsqueda rápida: devuelve {"ownerAddress": "0x..."}
agents.batchInfoagents[] (obligatorio, máximo 100), worknetId (obligatorio), chainId?Consulta por lotes: información del agente + su stake en el worknet especificado

Staking

MétodoParámetrosDescripción
staking.getBalanceaddress (obligatorio), chainId?Devuelve {totalStaked, totalAllocated, unallocated} en strings wei
staking.getUserBalanceGlobaladdress (obligatorio)Igual que arriba pero agregado en TODAS las cadenas
staking.getPositionsaddress (obligatorio), chainId?Array de posiciones veAWP: {tokenId, amount, lockEndTime, createdAt}
staking.getPositionsGlobaladdress (obligatorio)Posiciones en todas las cadenas (incluye chainId por posición)
staking.getAllocationsaddress (obligatorio), chainId?, page?, limit?Registros de asignación paginados: {agent, worknetId, amount}
staking.getFrozenaddress (obligatorio), chainId?Asignaciones congeladas (de worknets baneados)
staking.getPendingaddress (obligatorio), chainId?Asignaciones pendientes de confirmación
staking.getAgentWorknetStakeagent (obligatorio), worknetId (obligatorio)Total de stake asignado a un agente en un worknet específico (entre cadenas)
staking.getAgentWorknetsagent (obligatorio)Todos los worknetIds donde este agente tiene asignaciones no nulas
staking.getWorknetTotalStakeworknetId (obligatorio)Total de AWP stakeado en todos los agentes de un worknet

Worknets

MétodoParámetrosDescripción
worknets.liststatus?, chainId?, page?, limit?Lista worknets. Filtra por estado: Pending, Active, Paused, Banned
worknets.listRankedchainId?, page?, limit?Worknets ordenados por stake total (mayor primero)
worknets.searchquery (obligatorio, 1-100 caracteres), chainId?, page?, limit?Busca por nombre o símbolo (sin distinción de mayúsculas/minúsculas)
worknets.getByOwnerowner (obligatorio), chainId?, page?, limit?Worknets propiedad de la dirección
worknets.getworknetId (obligatorio)Detalles completos del worknet: nombre, símbolo, estado, alphaToken, pool LP, propietario, stakes
worknets.getSkillsworknetId (obligatorio)URI de skills (metadatos fuera de cadena que describen las capacidades del worknet)
worknets.getEarningsworknetId (obligatorio), page?, limit?Historial de ganancias AWP paginado por época
worknets.getAgentInfoworknetId (obligatorio), agent (obligatorio)Información de un agente en un worknet específico: stake, validez, destinatario de recompensas
worknets.listAgentsworknetId (obligatorio), chainId?, page?, limit?Agentes en el worknet ordenados por stake

Emisión

MétodoParámetrosDescripción
emission.getCurrentchainId?Número de época actual, cantidad de emisión diaria, peso total, época liquidada
emission.getSchedulechainId?Proyecciones de emisión: acumulado a 30, 90 y 365 días con decrecimiento aplicado
emission.getGlobalScheduleningunoMismas proyecciones pero agregadas en las 4 cadenas
emission.listEpochschainId?, page?, limit?Lista paginada de épocas liquidadas con totales de emisión
emission.getEpochDetailepochId (obligatorio), chainId?Desglose detallado: distribuciones de AWP por destinatario para una época específica

Tokens

MétodoParámetrosDescripción
tokens.getAWPchainId?Información del token AWP: totalSupply, maxSupply, circulatingSupply (por cadena)
tokens.getAWPGlobalningunoInformación de AWP agregada en todas las cadenas
tokens.getWorknetTokenInfoworknetId (obligatorio)Información del token Alpha: dirección, nombre, símbolo, totalSupply, minter
tokens.getWorknetTokenPriceworknetId (obligatorio)Precio Alpha/AWP desde el pool LP (caché de 10 min). Devuelve sqrtPriceX96 y precio legible.

Gobernanza

MétodoParámetrosDescripción
governance.listProposalsstatus?, chainId?, page?, limit?Lista propuestas. Estados: Active/Pending/Canceled/Defeated/Succeeded/Queued/Expired/Executed
governance.listAllProposalsstatus?, page?, limit?Lista de propuestas entre cadenas
governance.listGroupedpage?, limit?Vista fusionada entre cadenas — el mismo proposalId en distintas cadenas se fusiona en una entrada
governance.listByStatusGroupedstatus (obligatorio), page?, limit?Propuestas fusionadas donde al menos una cadena coincide con el estado
governance.getActivepage?, limit?Atajo a propuestas activas — equivalente a listByStatusGrouped(status="Active")
governance.getProposalproposalId (obligatorio, hex o decimal), chainId?Detalle enriquecido: votos en vivo, estado, top 100 votantes, quórum, cuerpo + url (solo señales), contentHash
governance.decodeProposalActionsproposalId (obligatorio), chainId?Decodifica calldata en llamadas a funciones legibles. Compatible con: AWPRegistry, AWPDAO, Treasury, AWPEmission, AWPAllocator, veAWP, AWPWorkNet
governance.getTimelineproposalId (obligatorio), chainId?Cronología completa del ciclo de vida: Created → VotingStarted → VotingEnded → Queued → Executed/Canceled
governance.getQuorumProgressproposalId (obligatorio), chainId?Progreso del quórum en tiempo real (bps), willPassIfEnded, deadline
governance.getEligibleTokensaddress (obligatorio), proposalId (obligatorio), chainId?Elegibilidad de NFT veAWP por propuesta (elegible si createdAt < proposalCreatedAt)
governance.getVotingPoweraddress (obligatorio), proposalId?, chainId?Poder de voto agregado de una dirección
governance.getVoterPowerproposalId (obligatorio), voter (obligatorio), chainId?Estado de un votante en una propuesta (hasVoted, weight, reason)
governance.getVoterVotesGlobalproposalId (obligatorio), voter (obligatorio)Votos entre cadenas de un votante en una propuesta
governance.listProposalVotesGlobalproposalId (obligatorio), grouped?, page?, limit?Todos los votantes entre cadenas para una propuesta
governance.getUserVoteHistoryaddress (obligatorio), page?, limit?Historial completo de votos del usuario en todas las propuestas
governance.getUserProposalsaddress (obligatorio), page?, limit?Propuestas enviadas por la dirección
governance.getApprovedProposerschainId?Proponentes en lista blanca (saltan el umbral de 200K AWP)
governance.isApprovedProposeraddress (obligatorio), chainId?Verifica si una dirección es un proponente aprobado
governance.getStatsningunoPanel de control de la DAO: total de propuestas, votantes, tasa de aprobación, desglose por estado
governance.getTreasuryningunoDevuelve 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...

Skills relacionados