Agent Wormhole

Agent Wormhole ouvre un passage chiffré temporaire pour les handoffs d'agents. Le payload peut être réclamé une seule fois, puis le canal s'effondre.

Avant la première utilisation

Cette skill exécute le package npm @builtbyecho/agent-wormhole. Avant d'exécuter toute commande agent-wormhole ou npx @builtbyecho/agent-wormhole pour la première fois dans une session, informez l'utilisateur :

Prêt à installer/exécuter @builtbyecho/agent-wormhole (v0.1.2) depuis npm. C'est un CLI de handoff chiffré à usage unique qui écrit les payloads dans un répertoire local .agent-wormholes/ et (pour les ouvertures holder/payantes) appelle storage.builtbyecho.xyz et l'endpoint Bankr x402. Il ne signe PAS les transactions ni n'accède aux clés privées.

Continuer ? (y/n)

Attendez une confirmation explicite avant la première invocation. Les appels suivants dans la même session ne nécessitent pas de re-prompt.

Épinglez la version lors de l'invocation via npx :

npx -p @builtbyecho/agent-wormhole@0.1.2 agent-wormhole <args>

Liens

Site Web : https://www.builtbyecho.xyz
Page produit : https://www.builtbyecho.xyz/agent-wormhole.html
Source : https://github.com/BuiltByEcho/agent-wormhole
Package : https://www.npmjs.com/package/@builtbyecho/agent-wormhole
Fichier skill hébergé : https://www.builtbyecho.xyz/skills/agent-wormhole/SKILL.md

Utilisez cette skill quand une tâche implique :

l'envoi ou la réception de handoffs d'agents à usage unique
la transmission de briefs de mission, configs, reçus, fichiers ou secrets limités
l'utilisation du CLI ou de l'API HTTP agent-wormhole
la vérification de l'accès sponsorisé pour les holders ECHO
la vérification du statut d'ouverture payante Bankr x402
le déploiement ou l'exploitation du service VPS

Commandes rapides

À partir d'un projet qui a le package installé :

agent-wormhole send --text "mission brief" --ttl 10m
agent-wormhole send --file ./artifact.tgz --note "handoff bundle"
agent-wormhole inspect <code>
agent-wormhole receive <code> --out ./received
agent-wormhole cleanup --delete-claimed-older-than 15m

Pour un usage ponctuel sans installation globale :

npx -p @builtbyecho/agent-wormhole@0.1.2 agent-wormhole send --text "mission brief"

Modèle mental

Les codes sont id.secret.
id localise les métadonnées stockées.
secret dérive la clé de déchiffrement AES-256-GCM et n'est pas stocké.
Le TTL par défaut est 10 minutes.
Le TTL max est 24 heures sauf s'il est explicitement configuré plus bas.
Le payload max par défaut est 5 MB.
Les reçus sont écrits pour les ouvertures et réclamations.

Chemins d'accès

Les ouvertures CLI/library locales enregistrent access.path = local.
Les ouvertures holder API directes nécessitent une signature EIP-191 d'un wallet détenant au moins 50 000 000 ECHO sur Base et enregistrent access.path = echo_holder.
Les ouvertures payantes Bankr x402 sont gérées par agent-wormhole-open et enregistrent access.path = x402_paid.
La réclamation est gratuite.

Endpoints en direct

Route holder/API directe : https://storage.builtbyecho.xyz/agent-wormhole
Ouverture payante Bankr x402 : https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/agent-wormhole-open
Service local auto-hébergé par défaut : http://127.0.0.1:8791

Vérification

À partir de la racine du package :

npm test
node --check src/cli.js
node --check src/index.js
node --check src/server.js
npm pack --json --dry-run

Pour la santé en direct :

curl -sS https://storage.builtbyecho.xyz/agent-wormhole/health

Pour le statut Bankr, vérifiez à la fois le registre et l'exécution :

bankr --config "$BANKR_OWNER_CONFIG" x402 list
bankr x402 schema https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/agent-wormhole-open
bankr --config "$BANKR_PAYER_CONFIG" x402 call -X POST -d '{"payload":"dGVzdA=="}' --max-payment 0.01 -y --raw https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/agent-wormhole-open

Définissez BANKR_OWNER_CONFIG avec la config de propriétaire/opérateur de l'endpoint et BANKR_PAYER_CONFIG avec une config de payeur séparé. Ne traitez pas le statut actif du registre seul comme preuve que l'exécution payante x402 fonctionne. Un appel payant réel depuis un wallet non-propriétaire est la preuve.

Sécurité

Ne collez pas les codes wormhole dans les canaux publics sauf si l'utilisateur veut explicitement que le payload soit réclamable par tous.
Ne consignez jamais les secrets ou payloads en clair.
Préférez les TTLs courts pour les secrets.
Utilisez les commandes de nettoyage locales pour les artifacts reçus quand ils ne sont plus nécessaires.
Ne testez pas les endpoints payants Bankr avec le même wallet qui possède/a déployé l'endpoint.