ponscli

Eine inoffizielle Kommandozeilen-Schnittstelle für das Pons-Launchpad auf der Robinhood Chain (Chain-ID 4663), entwickelt für Entwickler und Agenten gleichermaßen. Nicht verbunden mit Pons oder Robinhood; sie liest öffentliche Verträge auf einer öffentlichen Chain.

• Standardmäßig schreibgeschützt. Die CLI läuft, ohne jemals einen privaten Schlüssel zu sehen. Das Signieren ist ein explizites Opt-in, sodass ein Agent nicht versehentlich Geld ausgeben kann.

• Überall strukturierte Ausgabe. --json bei jedem Befehl, automatisch aktiviert, wenn stdout kein Terminal ist. Auch Fehler sind strukturiert, mit stabilen Exit-Codes.

• Protokollwerte werden von der Chain gelesen. Gebühren, Steuerfenster und die genehmigte Paar-Token-Liste werden live abgefragt, nie hartcodiert. Die On-Chain-Werte weichen vom Vertragsquellcode ab.

• Zweistufiges RPC. Kostenlose Endpunkte werden in Stufe 1 im Round-Robin-Verfahren verwendet; ein kostenpflichtiger Endpunkt in Stufe 2, der erst nach vollständiger Erschöpfung von Stufe 1 erreicht wird. Ohne kostenpflichtige Anmeldedaten degradiert Massenarbeit, anstatt einen Ausfall in eine Rechnung zu verwandeln.

• Zwei Binärdateien. pons für Menschen, pons-mcp für Modelle, über denselben Kern, sodass der Preis, den ein Agent angeboten bekommt, der Preis ist, den die CLI ausgibt.

Installation

npm install -g ponscli
pons --version

Oder ohne etwas zu installieren. Das Paket heißt ponscli und die Binärdatei heißt pons, also muss npx mitgeteilt werden, welche ausgeführt werden soll:

npx -p ponscli pons info 0x44D6…20f4

Zwei Node-Versionen sind wichtig, und es sind nicht dieselben. Die CLI läuft auf 20.11 oder neuer, was CI bei jedem Push überprüft, indem das gepackte Tarball genau auf dieser Version installiert wird. Erstellen erfordert 20.19 oder neuer, weil der Abhängigkeitsbaum des Linters dies verlangt. Aus einem Klon baut npm install als Teil der Installation, und npm run dev -- <Befehl> führt es aus dem Quellcode aus.

Related MCP server: r0x-os

Schnellstart

Lesen erfordert keinen Schlüssel, keine Wallet und keine Konfiguration.

pons info 0x44D6…20f4             # price, reserves, graduation phase, live snipe tax
pons pairs                        # every quote asset a launch may be priced in
pons watch 0x44D6…20f4            # follow one launch's trades as they happen
pons tx 0x2e8d…f58e               # receipt, decoded logs, and why a failure failed
pons doctor                       # probe every RPC endpoint with real calls

Handel erfordert einen Schlüssel. Nichts wird signiert, es sei denn, du sagst es.

pons wallet create                          # generate a key into an encrypted keystore
pons buy  0x44D6…20f4 0.05                  # price it, simulate it, print it. Nothing is sent
pons buy  0x44D6…20f4 0.05 --dry-run        # the same, said explicitly
pons buy  0x44D6…20f4 0.05 --confirm        # sign and broadcast
pons sell 0x44D6…20f4 50% --slippage 200

Alles ist maschinenlesbar, wenn es gepipet wird, und das ist der Standard:

pons info 0x44D6…20f4 | jq .graduation

Befehle

Vollständige Referenz, einschließlich welchen Vertrag jeder Befehl berührt: docs/commands.md.

Lesen, kein Schlüssel erforderlich

Handel, mit RPC und einem Schlüssel

Starten

Gebühren

Wallet und Einrichtung

Die zwei Generationen

Pons hat Token über zwei Fabriken gestartet, und beide werden unterstützt. Du musst nie sagen, welche du meinst: Beide Register werden abgefragt, und die Antwort entscheidet alles danach.

V1-Fabrik ist eingestellt. launchEnabled() ist seit 2026-08-12 falsch, und die Transaktion, die es gesetzt hat, ist das Letzte, was die Fabrik je ausgegeben hat; keine Adresse wurde jemals darüber hinaus auf die Whitelist gesetzt, also verweigert pons launch --generation v1 den Start, bevor etwas gebaut wird. Ihre Token sind eine andere Sache. Tausende halten immer noch Liquidität, und eine Stichprobe von vierzig Pools sah 223 Swaps in weniger als sechs Tagen, weshalb das Lesen und Handeln vollständig unterstützt wird.

Handel

Jeder Schreibvorgang erstellt zuerst einen Plan: was gesendet wird, an wen, was erwartet wird und was eine Warnung wert ist. Derselbe Plan wird simuliert und signiert, sodass die drei nicht auseinanderdriften können.

Vier Verhaltensweisen, die man kennen sollte:

• Der Venue ist keine Wahl, die du treffen musst. Der Startdatensatz sagt, wo das Token handelt. --route curve|v4|v3 überschreibt diese Antwort, anstatt nach einer zu suchen.

• Die Untergrenze wird festgelegt, wenn du sie akzeptierst. Der Plan wird unmittelbar vor dem Senden aus dem Live-Zustand neu erstellt, und die von dir akzeptierte Untergrenze wird in den Neubau übernommen, anstatt aus dem neuen Preis neu berechnet zu werden. Ein Trade kann nicht unter der von dir genehmigten Grenze signiert werden, und wenn der Preis darüber hinausgegangen ist, wird nichts gesendet.

• Ein Verkauf in eine Kurve an ihrer Schwelle wird umgeleitet, nicht fehlgeschlagen. Die Kurve stoppt den Handel, sobald sie genug gesammelt hat, und pons graduate <token> ist ein Aufruf, den jeder machen kann.

• Ein V1-Verkauf wird für dich entpackt. V1-Pools halten WETH statt ETH, also lässt ein Verkauf seine Erlöse am Router und entpackt sie in derselben Transaktion. Auf die offensichtliche Weise zu verkaufen würde funktionieren und dir WETH geben.

Starten

pons launch --name "My Token" --symbol MINE --desc "..."      # plan it and simulate it. Nothing is sent
pons launch --name "My Token" --symbol MINE --dry-run         # the same, said explicitly
pons launch --name "My Token" --symbol MINE \
  --pair USDG --creator-tax 250 --dev-buy 100 --confirm       # launch, quoted in USDG

Ein Start ist das Einzige hier, das nicht rückgängig gemacht werden kann. Bevor es eine Transaktion erstellt, gibt der Befehl das gesamte aus, wozu du dich verpflichtest: die Adresse, an der das Token landen wird, das Angebot, wohin es graduiert, die Gebührenaufteilung und was die Snipe-Steuer tun wird. Es prüft auch lokal alles, was die Fabrik auf der Chain ablehnen würde.

• Die Adresse ist bekannt, bevor du sendest. Beide Generationen setzen mit CREATE2 aus einem von dir gewählten Salt ein, also gibt pons launch die Token- und Kurvenadressen im Voraus aus und verweigert ein Salt, das bereits vergeben ist. --salt akzeptiert einen rohen 32-Byte-Wert, sodass eine geminte Vanity-Adresse funktioniert.

• Die Bedingungen sind festgelegt. previewLaunchEconomics gibt einen Digest zurück, der das Angebot, die Kurvengebühr, die Gebührenstufe des Pools und die Gebührenaufteilung des Protokolls abdeckt, und er reist mit dem Start. Wenn der Protokollinhaber eine davon ändert, während deine Transaktion in der Luft ist, wird der Start zurückgesetzt, anstatt leise neu zu bepreisen.

• --dev-buy ist atomar, und es muss sein. Die V2-Fabrik verlangt genau die Startgebühr und nichts mehr, also kann ein Eröffnungskauf nicht mitfahren; der Kauf geht stattdessen in derselben Transaktion durch den eigenen Router des Launchpads. Ein Start ohne einen wurde auf dieser Chain innerhalb von zwei Blöcken aufgekauft.

• --buyback kostet dich, nicht die Inhaber. Die Vault wird vollständig aus deinem eigenen Gebührenanteil finanziert und über fünf Jahre freigegeben, aufgeteilt mit dem Protokoll. Es ist keine Inhaberausschüttung, und der Plan sagt dies als Warnung, nicht als Fußnote.

pons pairs listet die Assets auf, in denen ein Start bepreist werden kann: natives ETH plus die dreiundzwanzig genehmigten Token, die tokenisierte Aktien, zwei Indexfonds und eine Stablecoin sind. Sie kommen in der Reihenfolge zurück, in der die Pons-Erstellungsseite sie rendert, sodass die beiden Zeile für Zeile übereinstimmen.

Sicherheit

• Schreibgeschützt ist der Standard. Kein Befehl signiert etwas ohne --confirm. Drei der vier Ausführungsmodi kosten nichts, und jeder von ihnen außer --unsigned beweist den Aufruf zuerst gegen die bereitgestellten Verträge, ohne dass das Konto Gelder hält.

• Der Keystore ist scrypt + AES-256-GCM, nur für den Eigentümer geschrieben. Ein Passwort kommt von einer versteckten Eingabeaufforderung oder PONS_PASSWORD; ein zu importierender Schlüssel kommt von PONS_PRIVATE_KEY.

• Keiner von beiden ist jemals ein Flag. Ein Argument ist in der Prozesstabelle sichtbar und landet in der Shell-Historie. Es gibt kein Flag, das eines von beiden akzeptiert, und pons config list sagt dies dort, wo jemand danach suchen würde.

• Anmeldedaten erreichen nie eine Logzeile. Ein kostenpflichtiger Endpunkt trägt seinen Schlüssel in der URL, und Fehlermeldungen betten URLs ein, also werden URLs in geworfenen Fehlern maskiert, nicht nur in formatierter Ausgabe.

• Der MCP-Server kann nicht signieren. Er lädt nie einen Keystore und sendet nie. Siehe docs/agents.md.

• Eine native Übertragung wird mit einem festen Gaslimit von 100.000 signiert. Nitro berechnet die L1-Postingkosten aus dem eigenen Limit der Transaktion, und eth_estimateGas sagt das nicht; bei 21.000 funktioniert eine Übertragung, während L1 billig ist, und schlägt intermittierend fehl, wenn es das nicht ist.

Etwas gefunden, das jemandem Geld kosten könnte? Bitte melde es privat. SECURITY.md erklärt das Wie, was im Rahmen liegt und was die Design-Garantien sind.

Konfiguration

Werte werden über eine Leiter aufgelöst: Flag > Umgebung > Konfigurationsdatei > Standard. pons config list gibt den aufgelösten Wert zusammen mit der Stufe aus, aus der er stammt, sodass eine überraschende Einstellung nur einen Befehl von einer Erklärung entfernt ist.

Die Konfigurationsdatei ist flaches JSON unter $XDG_CONFIG_HOME/ponscli/config.json (mit Fallback auf ~/.config/ponscli/config.json) und wird nur für den Besitzer geschrieben.

PONS_PASSWORD und PONS_PRIVATE_KEY werden aus der Umgebung gelesen, sind aber bewusst keine Konfigurationsschlüssel: Keiner von beiden gehört in eine Datei, die config list ausgibt und die Benutzer in Problemberichte einfügen.

Architektur

Das vollständige Dokument mit jeder Entscheidung und der dahinterstehenden Messung ist docs/architecture/ponscli.md. Die Form in Kürze:

src/core/       business logic, framework-free
src/commands/   thin CLI wiring
src/mcp/        the MCP server, also thin
src/chain/      the RPC waterfall
src/abi/        generated and committed

Beide Frontends sind Hüllen über src/core/. Genau das macht pons-mcp zu einem Wrapper und nicht zu einer zweiten Implementierung.

Wie Anfragen weitergeleitet werden

Tier 1 ist ein Round-Robin über kostenlose Endpunkte; Tier 2 ist ein kostenpflichtiger Endpunkt, der erst erreicht wird, nachdem jeder Tier-1-Kandidat versucht wurde. Jede Regel stammt aus einer Messung gegen die eigenen Endpunkte dieser Chain und nicht aus einer allgemeinen Wiederholungsrichtlinie. Diejenigen, die im Alltag am wichtigsten sind:

• Ein Revert ist eine Antwort, kein Fehler. Er kommt direkt zu dir zurück, statt über jeden Endpunkt erneut versucht und dann auf die kostenpflichtige Stufe eskaliert zu werden.

• Ein Rate-Limit parkt einen Endpunkt für 30 Sekunden, nicht für eine Stunde. Kostenlose Endpunkte sind Token-Buckets; ein langes Parken kostet mehr Verfügbarkeit als die Drosselung.

• Schreibvorgänge machen nie Round-Robin. Eine Nonce, die von einem Knoten genommen und an einen anderen gesendet wird, ist nonce too low, daher pinnen Transaktionen einen einzelnen Endpunkt.

• eth_chainId ist kein Health-Check. Ein öffentlicher Endpunkt beantwortet ihn schneller als jeder andere und lehnt dann eth_call ab. pons doctor testet aus genau diesem Grund mit echten Aufrufen.

ABIs

src/abi/ wird generiert und eingecheckt, sodass die CLI offline funktioniert und eine Schnittstellenänderung als überprüfbarer Diff erscheint.

npm run abi:fetch     # regenerate from Sourcify, falling back to Blockscout
npm run abi:check     # fail if the committed files have drifted

Jede Datei hält fest, woher ihr ABI stammt und wie die Übereinstimmung nachgewiesen wurde. Es gibt vier Herkunftsklassen, weil sich die Verträge unterscheiden:

Eine Datei wird von Hand geschrieben: erc20Errors.ts, die die Fehler enthält, mit denen Drittanbieter-Quote-Assets reverten. Ein Quote-Asset ist das Token eines anderen, es gibt kein einzelnes ABI, das die dreiundzwanzig genehmigten abdeckt, und ohne diese erscheint der gewöhnlichste Fehler bei einem USDG-Launch als vier unerklärte Bytes.

Für Agenten

Vollständiger Leitfaden: docs/agents.md.

pons-mcp wird in diesem Paket als zweite Binärdatei ausgeliefert und ruft dasselbe core/ auf wie die CLI.

// claude_desktop_config.json, .mcp.json, or your client's equivalent
{
  "mcpServers": {
    "pons": { "command": "pons-mcp" }
  }
}

Sechs Werkzeuge: pons_info, pons_pairs, pons_plan_buy, pons_plan_sell, pons_transaction, pons_endpoints.

Der Server kann nicht signieren, und es gibt kein Flag, das das ermöglicht. Er liest die Chain und erstellt unsignierte Transaktionen; eine Person sendet sie. Das ist das gesamte Sicherheitsmodell, und genau deshalb ist der Server sicher neben einem Modell laufen zu lassen: Das Schlimmste, was ein verwirrter Agent tun kann, ist, dir einen schlechten Preis zu nennen, nicht dein Geld auszugeben.

Antworten kommen in Basiseinheiten zurück, weil ein Modell exakte Arithmetik mit 50000000000000000 durchführen kann, nicht aber mit 0.05.

Für einen Agenten, der stattdessen die CLI aufruft, ist --json bereits die Standardeinstellung, wenn stdout kein Terminal ist, und ein Argumentfehler enthält die Verwendungszeile des fehlgeschlagenen Befehls, damit der Aufrufer sich selbst korrigieren kann:

{
  "ok": false,
  "error": {
    "code": "USAGE",
    "message": "missing required argument 'token'",
    "hint": "run 'pons info --help'",
    "details": { "command": "info", "usage": "pons info [options] <token>" }
  }
}

Agentisches Programmieren

Dieses Repository enthält seine eigene Agentenkonfiguration. CLAUDE.md ist die Projektbeschreibung, mit AGENTS.md, das für Codex, Cursor, Copilot und andere darauf verlinkt ist.

Testen

npm run typecheck
npm run lint
npm test
npm run build

Die Suite ist vollständig offline. Jeder Test treibt die echte Befehlsfläche gegen test/fakeChain.ts, eine Tabelle aus Adresse + ABI + Funktion → Ergebnis, die auch Multicall3 und eth_getLogs bedient, sodass dieselbe Dekodierung und Aggregation wie im Live-Pfad getestet wird.

Zwei Prüfungen erreichen das Netzwerk und sind bewusst nicht Teil von npm test:

npm run test:sequence   # prove multi-block sequences against live mainnet state
npm run abi:check       # fail if a committed ABI has drifted from its verified source

Sequenzen ohne lokalen Knoten

Eine Simulation beweist einen Aufruf gegen einen Block. Sie kann nicht beweisen, dass eine Genehmigung ankommt und der Verkauf im nächsten Block dann gelingt, oder dass ein Launch bestätigt wird und die erstellte Kurve einen Block später kaufbar ist. Das sind die Fehler, die einen Benutzer erreichen.

Robinhood Chain beantwortet eth_simulateV1, das mehrere Blöcke mit mehreren Aufrufen ausführt, wobei der Zustand über alle hinweg erhalten bleibt, gegen den Live-Mainnet-Zustand. npm run test:sequence nutzt es, um sechs Sequenzen zu beweisen, einschließlich des gesamten Lebenszyklus eines Launches: erstellt, gehandelt, über seine Graduierungsschwelle hinaus gebracht und in einen Uniswap-V4-Pool eingespeist. Kein lokaler Knoten, kein Foundry, nichts ausgegeben.

Jede Sequenz enthält eine Kontrolle, die fehlschlagen muss. Ohne eine solche könnte eine Zustandsüberschreibung die Arbeit erledigen, die die Sequenz zu beweisen scheint.

Absichtlich echtes Geld ausgeben

scripts/mainnet-e2e.sh startet einen Token, kauft ihn, verkauft ihn und beansprucht die Gebühren gegen Mainnet, wirklich. Sequenzen werden durch die obige Prüfung kostenlos abgedeckt, also fügt dies das eine hinzu, was Simulation nicht kann: eine echte Transaktion, signiert mit einem echten Schlüssel, vom echten Mempool akzeptiert, mit einer echten Quittung zum Dekodieren. Es ist aus, es sei denn, du sagst es, fragt vor jeder Transaktion und darf niemals in CI laufen.

PONS_E2E=i-understand ./scripts/mainnet-e2e.sh

Exit-Codes

Skripte und Agenten können anhand des Ergebnisses verzweigen, ohne Prosa zu parsen.

Im --json-Modus schreibt ein Fehler {"ok": false, "error": {...}} nach stderr, nie nach stdout, sodass eine Pipe nur Ergebnisse transportiert.

Mitwirken

Siehe CONTRIBUTING.md und SECURITY.md für alles, was kein öffentliches Problem sein sollte. Die Kurzfassung: Führe die vier obigen Prüfungen aus, behalte neues Verhalten in src/core/ und verifiziere jede Behauptung über das Protokoll gegen Mainnet, bevor du sie niederschreibst. Die Vertragsquellen sind an mehreren wichtigen Stellen veraltet.

Über

Von Grund auf in TypeScript auf viem geschrieben. Kein Quellcode wird aus einem Repository kopiert: Die Befehlsfläche ist aus einer Verhaltenskarte von chainstacklabs/pumpfun-cli abgeleitet und die RPC-Richtlinie aus Messungen gegen die eigenen Endpunkte dieser Chain.

Pons selbst ist unter ponsfamily.com zu finden: der Web-Client zum Starten und Erkunden, seine Analysen und seine Dokumentation. Diese CLI ist nicht Teil davon, wird nicht von ihm unterstützt und spricht mit denselben öffentlichen Verträgen, die jeder andere auch nutzen kann.

Lizenz

MIT. Siehe LICENSE.