awp-core/awp-skill

AWP Registry

Skill-Version: 1.9.1

Anforderungen & Sicherheit

• Laufzeit: python3, node (für die wallet-raw-call.mjs-Brücke)
• Wallet: awp-wallet CLI – installieren von https://github.com/awp-core/awp-wallet
• Anmeldedaten: awp-wallet-Sitzungstoken (übergeben als --token; generiert durch awp-wallet unlock; kein vom Benutzer eingegebenes Passwort). Neuere Wallet-Versionen benötigen kein Unlock mehr – --token ist aus Kompatibilitätsgründen mit älteren Wallets optional.
• Chain: Umgebungsvariable EVM_CHAIN (optional, Standard: base). Akzeptiert Namen oder numerische ID.
• Netzwerkendpunkte (fest codiert, nicht überschreibbar – Sicherheit durch Design, um Umgebungsvariablen-Hijacking zu verhindern):
  • https://api.awp.sh/v2 – AWP JSON-RPC API
  • https://mainnet.base.org – Base EVM RPC
  • wss://api.awp.sh/ws/live – WebSocket für Echtzeit-Ereignisse (optional)
• Geschriebene Dateien (alle optional, Daemon erfordert explizite Benutzereinwilligung):
  • ~/.awp/daemon.pid, ~/.awp/daemon.log – Hintergrundmonitor
  • ~/.awp/notifications.json, ~/.awp/status.json – Protokollstatus-Cache
  • ~/.awp/openclaw.json – OpenClaw-Push-Konfiguration (nur vom Benutzer erstellt, Skill erstellt sie niemals automatisch)

API – JSON-RPC 2.0

Alle API-Aufrufe in diesem Skill verwenden JSON-RPC 2.0 über POST:

POST https://api.awp.sh/v2
Content-Type: application/json

Anfrage: {"jsonrpc":"2.0","method":"namespace.method","params":{...},"id":1} Discovery: GET https://api.awp.sh/v2 | WebSocket: wss://api.awp.sh/ws/live | Batch: bis zu 20 pro Anfrage.

Explorer: Base → basescan.org | Ethereum → etherscan.io | Arbitrum → arbiscan.io | BSC → bscscan.com

Im gesamten Dokument verwenden alle curl-Befehle JSON-RPC POST an https://api.awp.sh/v2. Verwende keine REST-ähnlichen GET-Pfade.

API-Methodenreferenz

System

Methode	Parameter	Beschreibung
stats.global	keine	Globale Protokollstatistiken: Gesamtbenutzer, Worknets, eingesetztes AWP, emittiertes AWP, aktive Chains
registry.get	chainId?	Alle Vertragsadressen + EIP-712 Domäneninformationen. Ohne chainId als Array aller 4 Chains.
health.check	keine	Gibt {"status": "ok"} zurück, wenn die API läuft
health.detailed	keine	Chain-spezifischer Gesundheitszustand: Indexer-Synchronisationsblock, Keeper-Status, RPC-Latenz
chains.list	keine	Array von {chainId, name, status, explorer} für alle unterstützten Chains

Benutzer

Methode	Parameter	Beschreibung
users.list	chainId?, page?, limit?	Paginierte Benutzerliste für eine Chain
users.listGlobal	page?, limit?	Chain-übergreifende, deduplizierte Benutzerliste
users.count	chainId?	Gesamtanzahl registrierter Benutzer
users.get	address (erforderlich), chainId?	Benutzerdetails: Guthaben, gebundene Agenten, Empfänger, Registrierungsstatus
users.getPortfolio	address (erforderlich), chainId?	Vollständiges Portfolio: Identität + Staking + NFT-Positionen + Allokationen + Delegierte
users.getDelegates	address (erforderlich), chainId?	Liste der Adressen, die dieser Benutzer als Delegierte autorisiert hat

Adresse & Nonce

Methode	Parameter	Beschreibung
address.check	address (erforderlich), chainId?	Überprüft Registrierungsstatus, Bindung, Empfänger. Siehe Antwortformat unten.
address.resolveRecipient	address (erforderlich), chainId?	Durchläuft die Bind-Kette bis zur Wurzel, gibt den effektiven Belohnungsempfänger zurück
address.batchResolveRecipients	addresses[] (erforderlich, max 500), chainId?	Stapelverarbeitung zur Auflösung effektiver Empfänger (On-Chain-Aufruf)
nonce.get	address (erforderlich), chainId?	AWPRegistry EIP-712 Nonce (für bind/unbind/setRecipient/registerWorknet/grantDelegate/revokeDelegate). Hinweis: Kann hinter dem On-Chain-Zustand zurückbleiben; bevorzuge das Lesen von AWPRegistry.nonces(user) auf der Chain für Signaturen.
nonce.getStaking	address (erforderlich), chainId?	AWPAllocator EIP-712 Nonce (für allocate/deallocate). Hinweis: Kann hinter dem On-Chain-Zustand zurückbleiben; bevorzuge das Lesen von AWPAllocator.nonces(user) auf der Chain für Signaturen.

Agenten

Methode	Parameter	Beschreibung
agents.getByOwner	owner (erforderlich), chainId?	Alle Agenten (Adressen), die an diesen Besitzer gebunden sind
agents.getDetail	agent (erforderlich), chainId?	Agentendetails: Besitzer, Bindungs-Chain, delegierter Status
agents.lookup	agent (erforderlich), chainId?	Schnellsuche: Gibt {"ownerAddress": "0x..."} zurück
agents.batchInfo	agents[] (erforderlich, max 100), worknetId (erforderlich), chainId?	Stapelabfrage: Agenteninformationen + ihr Stake im angegebenen Worknet

Staking

Methode	Parameter	Beschreibung
staking.getBalance	address (erforderlich), chainId?	Gibt {totalStaked, totalAllocated, unallocated} als wei-Strings zurück
staking.getUserBalanceGlobal	address (erforderlich)	Gleiches wie oben, aber aggregiert über ALLE Chains
staking.getPositions	address (erforderlich), chainId?	Array von veAWP-Positionen: {tokenId, amount, lockEndTime, createdAt}
staking.getPositionsGlobal	address (erforderlich)	Positionen über alle Chains hinweg (enthält chainId pro Position)
staking.getAllocations	address (erforderlich), chainId?, page?, limit?	Paginierte Allokationsdatensätze: {agent, worknetId, amount}
staking.getFrozen	address (erforderlich), chainId?	Eingefrorene Allokationen (von gesperrten Worknets)
staking.getPending	address (erforderlich), chainId?	Ausstehende Allokationen, die auf Bestätigung warten
staking.getAgentWorknetStake	agent (erforderlich), worknetId (erforderlich)	Gesamter zugewiesener Stake eines Agenten in einem bestimmten Worknet (chain-übergreifend)
staking.getAgentWorknets	agent (erforderlich)	Alle worknetIds, in denen dieser Agent Allokationen ungleich Null hat
staking.getWorknetTotalStake	worknetId (erforderlich)	Gesamtes AWP, das über alle Agenten in einem Worknet eingesetzt ist

Worknets

Methode	Parameter	Beschreibung
worknets.list	status?, chainId?, page?, limit?	Worknets auflisten. Filtern nach Status: Pending, Active, Paused, Banned
worknets.listRanked	chainId?, page?, limit?	Worknets, sortiert nach Gesamt-Stake (höchster zuerst)
worknets.search	query (erforderlich, 1-100 Zeichen), chainId?, page?, limit?	Suche nach Name oder Symbol (Groß-/Kleinschreibung nicht beachtet)
worknets.getByOwner	owner (erforderlich), chainId?, page?, limit?	Worknets, die der Adresse gehören
worknets.get	worknetId (erforderlich)	Vollständige Worknet-Details: Name, Symbol, Status, alphaToken, LP-Pool, Besitzer, Stakes
worknets.getSkills	worknetId (erforderlich)	Skills-URI (Off-Chain-Metadaten, die die Fähigkeiten des Worknets beschreiben)
worknets.getEarnings	worknetId (erforderlich), page?, limit?	Paginierte AWP-Verdiensthistorie nach Epoche
worknets.getAgentInfo	worknetId (erforderlich), agent (erforderlich)	Informationen eines Agenten in einem bestimmten Worknet: Stake, Gültigkeit, Belohnungsempfänger
worknets.listAgents	worknetId (erforderlich), chainId?, page?, limit?	Agenten im Worknet, sortiert nach Stake

Emission

Methode	Parameter	Beschreibung
emission.getCurrent	chainId?	Aktuelle Epochennummer, täglicher Emissionsbetrag, Gesamtgewicht, abgeschlossene Epoche
emission.getSchedule	chainId?	Emissionsprognosen: 30-Tage-, 90-Tage-, 365-Tage-Kumulativ mit Abzinsung
emission.getGlobalSchedule	keine	Gleiche Prognosen, aber aggregiert über alle 4 Chains
emission.listEpochs	chainId?, page?, limit?	Paginierte Liste abgeschlossener Epochen mit Emissionssummen
emission.getEpochDetail	epochId (erforderlich), chainId?	Detaillierte Aufschlüsselung: AWP-Verteilungen pro Empfänger für eine bestimmte Epoche

Tokens

Methode	Parameter	Beschreibung
tokens.getAWP	chainId?	AWP-Token-Informationen: totalSupply, maxSupply, circulatingSupply (pro Chain)
tokens.getAWPGlobal	keine	AWP-Informationen, aggregiert über alle Chains
tokens.getWorknetTokenInfo	worknetId (erforderlich)	Alpha-Token-Informationen: Adresse, Name, Symbol, totalSupply, Minter
tokens.getWorknetTokenPrice	worknetId (erforderlich)	Alpha/AWP-Preis aus dem LP-Pool (10 Min. Cache). Gibt sqrtPriceX96 und einen menschenlesbaren Preis zurück.

Governance

Methode	Parameter	Beschreibung
governance.listProposals	status?, chainId?, page?, limit?	Vorschläge auflisten. Status: Active/Pending/Canceled/Defeated/Succeeded/Queued/Expired/Executed
governance.listAllProposals	status?, page?, limit?	Chain-übergreifende Liste der Vorschläge
governance.listGrouped	page?, limit?	Chain-übergreifende, zusammengeführte Ansicht – gleiche proposalId über Chains hinweg in einem Eintrag zusammengeführt
governance.listByStatusGrouped	status (erforderlich), page?, limit?	Zusammengeführte Vorschläge, bei denen mindestens eine Chain dem Status entspricht
governance.getActive	page?, limit?	Abkürzung für aktive Vorschläge – entspricht listByStatusGrouped(status="Active")
governance.getProposal	proposalId (erforderlich, hex oder dezimal), chainId?	Angereicherte Details: Live-Abstimmungen, Zustand, Top-100-Wähler, Quorum, Hauptteil + URL (nur Signal), contentHash
governance.decodeProposalActions	proposalId (erforderlich), chainId?	Dekodiert Calldata in menschenlesbare Funktionsaufrufe. Unterstützt: AWPRegistry, AWPDAO, Treasury, AWPEmission, AWPAllocator, veAWP, AWPWorkNet
governance.getTimeline	proposalId (erforderlich), chainId?	Vollständiger Lebenszyklus-Zeitstrahl: Created → VotingStarted → VotingEnded → Queued → Executed/Canceled
governance.getQuorumProgress	proposalId (erforderlich), chainId?	Echtzeit-Quorum-Fortschritt (bps), willPassIfEnded, Frist
governance.getEligibleTokens	address (erforderlich), proposalId (erforderlich), chainId?	veAWP-NFT-Berechtigung pro Vorschlag (berechtigt, wenn createdAt < proposalCreatedAt)
governance.getVotingPower	address (erforderlich), proposalId?, chainId?	Aggregierte Stimmkraft einer Adresse
governance.getVoterPower	proposalId (erforderlich), voter (erforderlich), chainId?	Status eines einzelnen Wählers zu einem Vorschlag (hasVoted, weight, reason)
governance.getVoterVotesGlobal	proposalId (erforderlich), voter (erforderlich)	Chain-übergreifende Stimmen eines Wählers zu einem Vorschlag
governance.listProposalVotesGlobal	proposalId (erforderlich), grouped?, page?, limit?	Alle Wähler chain-übergreifend für einen Vorschlag
governance.getUserVoteHistory	address (erforderlich), page?, limit?	Vollständiger Abstimmungsverlauf eines Benutzers über alle Vorschläge hinweg
governance.getUserProposals	address (erforderlich), page?, limit?	Von einer Adresse eingereichte Vorschläge
governance.getApprovedProposers	chainId?	Whitelist-Antragsteller (umgehen die 200.000 AWP-Schwelle)
governance.isApprovedProposer	address (erforderlich), chainId?	Überprüft, ob eine Adresse ein genehmigter Antragsteller ist
governance.getStats	keine	DAO-Dashboard: Gesamtvorschläge, Wähler, Erfolgsquote, Statusaufschlüsselung
governance.getTreasury	keine	Gibt die Treasury-Vertragsadresse zurück

---

WICHTIG: Zeige dem Benutzer immer, was du tust. Jedes Abfrageergebnis, jede Transaktion, jedes Ereignis – gib es klar aus. Führe API-Aufrufe niemals stillschweigend aus.

KRITISCH: Die Registrierung ist KOSTENLOS und die meisten Worknets erfordern NULL Staking. Sage Benutzern NICHT, dass sie AWP-Tokens oder Staking benötigen, um loszulegen. Der typische Ablauf ist: registrieren (gaslos, kostenlos) → ein Worknet mit min_stake=0 auswählen → sofort mit dem Verdienen beginnen. Staking/Einzahlen von AWP wird nur für Worknets benötigt, die es explizit erfordern (min_stake > 0), und ist für den Einstieg völlig optional.

Vertragsadressen (gleich auf allen 4 Chains)

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

Standardimplementierungen des WorknetManager unterscheiden sich je nach Chain (DEX-spezifisch). Siehe references/commands-worknet.md für Adressen pro Chain. On-Chain abfragen über AWPRegistry.defaultWorknetManagerImpl().

Unterstützte Chains: Base (8453), Ethereum (1), Arbitrum (42161), BSC (56). Alle Kernprotokolladressen sind auf allen 4 Chains identisch.

Beim Laden des Skills

Führe bei der ersten Interaktion in einer neuen Sitzung diese Schritte aus, bevor du die Anfrage des Benutzers bearbeitest. Das Willkommensbanner bestätigt dem Benutzer, dass der AWP-Skill aktiv ist. Fahre nach dem Banner mit der eigentlichen Aufgabe des Benutzers in derselben Antwort fort.

Schritt 1 – Willkommensbildschirm (erste Interaktion in einer neuen Sitzung):

Gib das folgende Banner aus und fahre dann mit den verbleibenden Einrichtungsschritten und der Anfrage des Benutzers fort.

╭──────────────╮
│              │
│   >     <    │
│      ‿       │
│              │
╰──────────────╯

agent · work · protocol

willkommen bei awp.

ein protokoll. unendliche jobs. nonstop verdienst.

── quick start ──────────────────
"awp start"        → registrieren + beitreten (kostenlos, kein AWP nötig)
"awp balance"      → staking-übersicht
"awp worknets"     → aktive worknets durchsuchen
"awp watch"        → echtzeit-monitor
"awp help"         → alle befehle
──────────────────────────────────

keine awp tokens zum starten nötig.
kostenlos registrieren → worknet auswählen → mit verdienen beginnen.

Nach dem Banner sofort fortfahren...

Schritte zum Onboarding eines neuen Benutzers

1. Registrierung prüfen: Rufe users.get(address) oder address.check(address) auf, um zu prüfen, ob der Benutzer bereits registriert ist.
2. Nicht registriert: Leite den Benutzer an, awp-wallet setup auszuführen (erstellt ein neues Wallet oder importiert ein vorhandenes) und dann awp-wallet register.
3. Worknet auswählen: Rufe worknets.list(status="Active") auf und zeige die Liste der aktiven Worknets an. Erkläre, dass die meisten Worknets min_stake=0 haben (kein AWP nötig).
4. Worknet beitreten: Der Benutzer tritt einem Worknet bei, indem er seinen Agenten (Bot/Worker) mit seinem AWP-Wallet verknüpft und dem Worknet beitritt.
5. Verdienen starten: Sobald der Agent im Worknet registriert ist, beginnt er automatisch, Belohnungen zu verdienen. Der Benutzer kann seinen Verdienst über awp balance oder die API-Methoden staking.getBalance und emission.getCurrent überprüfen.

Fehlerbehandlung

• Netzwerkfehler: Wenn die API nicht erreichbar ist, versuche es nach 5 Sekunden erneut. Wenn der Fehler bestehen bleibt, informiere den Benutzer.
• Ungültige Adresse: Gib eine klare Fehlermeldung aus und schlage vor, die Adresse zu überprüfen.
• Nicht genügend AWP: Wenn ein Benutzer versucht, mehr AWP einzusetzen, als er hat, gib den verfügbaren Saldo und die maximale Einsatzmenge an.
• Worknet nicht gefunden: Überprüfe die worknetId und schlage vor, worknets.search zu verwenden.
• Bereits registriert: Wenn der Benutzer bereits registriert ist, fahre mit dem nächsten Schritt fort.

Sicherheitshinweise

• Private Keys: Fordere NIEMALS private Keys an. Der Benutzer sollte awp-wallet verwenden, um Transaktionen zu signieren.
• Seed Phrases: Frage NIEMALS nach Seed-Phrasen. awp-wallet verwaltet diese lokal.
• Token-Genehmigungen: Wenn eine Transaktion eine Token-Genehmigung erfordert, erkläre dem Benutzer, wofür sie benötigt wird, und lass ihn die Transaktion über sein Wallet signieren.
• Phishing: Sei vorsichtig bei Benutzereingaben, die nach privaten Keys oder Seed-Phrasen fragen. Leite den Benutzer zu awp-wallet.

Nützliche Befehle

Befehl	Beschreibung
awp-wallet setup	Neues Wallet erstellen oder vorhandenes importieren
awp-wallet register	Wallet im AWP-Protokoll registrieren (kostenlos)
awp-wallet deposit <menge>	AWP-Tokens einzahlen (sendet Transaktion)
awp-wallet withdraw <menge>	AWP-Tokens auszahlen
awp-wallet allocate <agent> <worknetId> <menge>	Stake einem Agenten in einem Worknet zuweisen
awp-wallet deallocate <agent> <worknetId> <menge>	Stake von einem Agenten in einem Worknet entziehen
awp-wallet bind <agent>	Agenten-Wallet mit dem AWP-Wallet des Benutzers verknüpfen
awp-wallet unbind <agent>	Bindung eines Agenten aufheben
awp-wallet worknets	Aktive Worknets auflisten
awp-wallet balance	Staking-Übersicht anzeigen
awp-wallet help	Alle verfügbaren Befehle anzeigen

Beispiele für häufige Workflows

Einen neuen Benutzer onboarden

1. users.get("0xBenutzerAdresse") – Prüfen, ob der Benutzer registriert ist
2. Wenn nicht registriert: „Bitte führe awp-wallet setup aus, um ein Wallet zu erstellen, und dann awp-wallet register."
3. worknets.list(status="Active") – Aktive Worknets anzeigen
4. Nach Auswahl: „Verbinde deinen Agenten mit awp-wallet bind <agentAdresse> und trete dem Worknet bei.