ponscli

비공식 Pons 런치패드용 커맨드라인 인터페이스로, Robinhood Chain (체인 ID 4663)에서 동작하며 개발자와 에이전트 모두를 위해 만들어졌습니다. Pons나 Robinhood와 제휴하지 않으며, 공개 체인의 공개 계약을 읽습니다.

• 기본적으로 읽기 전용. CLI는 개인 키를 절대 보지 않고 실행됩니다. 서명은 명시적으로 선택할 때만 이루어지므로 에이전트가 실수로 지출할 수 없습니다.

• 모든 곳에서 구조화된 출력. 모든 명령에 --json이 있으며, stdout이 터미널이 아닐 때 자동으로 활성화됩니다. 오류도 구조화되어 있으며 안정적인 종료 코드를 사용합니다.

• 프로토콜 값은 체인에서 읽습니다. 수수료, 세금 창, 승인된 페어 토큰 목록은 실시간으로 조회되며 하드코딩되지 않습니다. 온체인 값은 계약 소스와 다릅니다.

• 2계층 RPC. Tier 1에서는 무료 엔드포인트를 라운드로빈 방식으로 사용하고, Tier 2의 유료 엔드포인트는 Tier 1이 완전히 소진된 후에만 도달합니다. 유료 자격 증명이 없으면 대량 작업은 중단을 청구서로 바꾸는 대신 성능이 저하됩니다.

• 두 개의 바이너리. 사람용 pons와 모델용 pons-mcp가 동일한 코어 위에서 동작하므로 에이전트가 받는 가격은 CLI가 출력하는 가격과 동일합니다.

설치

npm install -g ponscli
pons --version

또는 아무것도 설치하지 않고 사용할 수 있습니다. 패키지는 ponscli이고 바이너리는 pons이므로 npx에 어떤 것을 실행할지 알려줘야 합니다:

npx -p ponscli pons info 0x44D6…20f4

두 가지 Node 버전이 중요하며, 같은 버전이 아닙니다. CLI는 20.11 이상에서 실행되며, CI는 푸시할 때마다 정확히 그 버전에 패키지된 tarball을 설치하여 확인합니다. 빌드에는 20.19 이상이 필요합니다. 린터의 의존성 트리가 요구하기 때문입니다. 클론에서 npm install은 설치의 일부로 빌드하며, npm run dev -- <command>는 소스에서 실행합니다.

Related MCP server: r0x-os

빠른 시작

읽기에는 키, 지갑, 구성이 필요 없습니다.

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

거래에는 키가 필요합니다. 명시하지 않는 한 아무것도 서명되지 않습니다.

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

파이프로 연결하면 모든 것이 기계가 읽을 수 있는 형태이며, 이것이 기본값입니다:

pons info 0x44D6…20f4 | jq .graduation

명령어

각 명령이 어떤 계약에 접근하는지 포함한 전체 참조: docs/commands.md.

읽기, 키 불필요

거래, RPC 및 키 필요

런칭

수수료

지갑 및 설정

두 세대

Pons는 두 개의 팩토리를 통해 토큰을 출시했으며, 둘 다 지원됩니다. 어느 것을 의미하는지 말할 필요가 없습니다. 두 레지스트리 모두 조회되며, 그 답이 이후의 모든 것을 결정합니다.

V1의 팩토리는 은퇴했습니다. launchEnabled()는 2026-08-12 이후 false이며, 이를 설정한 트랜잭션이 팩토리가 마지막으로 방출한 것입니다. 그 이후로 어떤 주소도 화이트리스트에 등록된 적이 없으므로 pons launch --generation v1은 아무것도 만들기 전에 거부합니다. 그러나 그 토큰들은 다른 문제입니다. 수천 개가 여전히 유동성을 보유하고 있으며, 40개 풀 샘플에서 6일 미만 동안 223건의 스왑이 발생했습니다. 그래서 이들을 읽고 거래하는 것이 완전히 지원됩니다.

거래

모든 쓰기 작업은 먼저 Plan을 만듭니다: 무엇을 보낼지, 누구에게 보낼지, 무엇을 기대하는지, 그리고 경고할 가치가 있는 것이 무엇인지. 그 동일한 Plan이 시뮬레이션되고 서명되므로 세 가지가 서로 어긋날 수 없습니다.

알아둘 만한 네 가지 동작:

• 거래 장소는 선택할 필요가 없습니다. 런칭 기록에 토큰이 거래되는 위치가 나와 있습니다. --route curve|v4|v3는 검색하는 대신 그 답을 덮어씁니다.

• 수락할 때 하한선이 고정됩니다. 브로드캐스트 직전에 플랜이 라이브 상태에서 다시 빌드되며, 수락한 하한선은 새 가격에서 다시 계산되지 않고 재빌드에 그대로 전달됩니다. 승인한 한도 아래로는 거래가 서명될 수 없으며, 가격이 그 한도를 넘어 움직였다면 아무것도 보내지 않습니다.

• 임계값에 도달한 커브에 대한 매도는 실패가 아니라 리디렉션됩니다. 커브는 충분히 모금되면 거래를 중단하며, pons graduate <token>은 누구나 호출할 수 있습니다.

• V1 매도는 자동으로 언랩됩니다. V1 풀은 ETH 대신 WETH를 보유하므로, 매도는 수익을 라우터에 남기고 같은 트랜잭션에서 언랩합니다. 당연한 방식으로 매도해도 작동하며 WETH를 받게 됩니다.

런칭

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

런칭은 여기서 되돌릴 수 없는 유일한 것입니다. 트랜잭션을 만들기 전에 명령은 당신이 약속하는 모든 것을 출력합니다: 토큰이 배치될 주소, 공급량, 졸업 위치, 수수료 분할, 스나이프 세금이 무엇을 할지. 또한 팩토리가 온체인에서 거부할 모든 것을 로컬에서 확인합니다.

• 주소는 보내기 전에 알 수 있습니다. 두 세대 모두 선택한 salt로 CREATE2를 사용하여 배포하므로 pons launch는 토큰과 커브 주소를 미리 출력하고 이미 사용된 salt는 거부합니다. --salt는 원시 32바이트 값을 허용하므로 채굴된 배니티 주소도 작동합니다.

• 조건은 고정됩니다. previewLaunchEconomics는 공급량, 커브 수수료, 풀의 수수료 등급, 프로토콜 수수료 분할을 포함한 다이제스트를 반환하며, 이는 런칭과 함께 이동합니다. 프로토콜 소유자가 트랜잭션이 진행되는 동안 이 중 하나라도 변경하면 런칭은 조용히 가격을 다시 매기는 대신 되돌아갑니다.

• --dev-buy는 원자적이며, 그래야만 합니다. V2 팩토리는 정확히 런칭 수수료만 요구하며 그 이상은 없으므로 오프닝 구매가 함께 갈 수 없습니다. 대신 구매는 같은 트랜잭션에서 런치패드 자체 라우터를 통해 이루어집니다. 이 옵션 없이 런칭하면 이 체인에서 두 블록 안에 매수되어 버렸습니다.

• --buyback은 보유자가 아닌 당신에게 비용이 듭니다. 금고는 전적으로 당신의 수수료 몫으로 자금이 조성되며 5년에 걸쳐 프로토콜과 분할하여 방출됩니다. 보유자 분배가 아니며, 플랜은 각주가 아닌 경고로 이를 명시합니다.

pons pairs는 런칭이 가격이 매겨질 수 있는 자산을 나열합니다: 네이티브 ETH와 승인된 23개 토큰(토큰화된 주식, 두 개의 인덱스 펀드, 하나의 스테이블코인)입니다. Pons 생성 페이지가 렌더링하는 순서대로 반환되므로 두 항목이 행 단위로 일치합니다.

보안

• 읽기 전용이 기본입니다. --confirm 없이는 어떤 명령도 서명하지 않습니다. 네 가지 실행 모드 중 세 가지는 비용이 들지 않으며, --unsigned를 제외한 모든 모드는 계정에 자금이 없어도 먼저 배포된 계약에 대해 호출을 검증합니다.

• 키스토어는 scrypt + AES-256-GCM이며 소유자만 쓸 수 있습니다. 비밀번호는 숨겨진 프롬프트 또는 PONS_PASSWORD에서 오고, 가져올 키는 PONS_PRIVATE_KEY에서 옵니다.

• 둘 다 플래그가 아닙니다. 인수는 프로세스 테이블에 표시되고 셸 히스토리에 남습니다. 둘 중 하나를 받는 플래그는 없으며, pons config list는 누군가 찾을 만한 곳에서 그렇게 말합니다.

• 자격 증명은 로그 줄에 도달하지 않습니다. 유료 엔드포인트는 URL에 키를 포함하고 오류 메시지는 URL을 포함하므로, URL은 형식화된 출력뿐만 아니라 발생한 오류 내부에서도 마스킹됩니다.

• MCP 서버는 서명할 수 없습니다. 키스토어를 로드하지 않으며 브로드캐스트하지 않습니다. docs/agents.md를 참조하세요.

• 네이티브 전송은 고정된 100,000 가스 한도로 서명됩니다. Nitro는 L1 게시 비용을 트랜잭션 자체 한도에서 청구하며 eth_estimateGas는 이를 알려주지 않습니다. 21,000에서는 L1이 저렴할 때 전송이 작동하고, 그렇지 않을 때 간헐적으로 실패합니다.

누군가의 자금을 잃게 할 수 있는 무언가를 발견했나요? 비공개로 신고해 주세요. SECURITY.md에 방법, 범위, 그리고 설계 보장 사항이 나와 있습니다.

구성

값은 플래그 > 환경 변수 > 구성 파일 > 기본값 순서로 결정됩니다. pons config list는 결정된 값과 그 값이 어느 단계에서 왔는지를 함께 출력하므로, 예상 밖의 설정도 명령 하나로 설명을 확인할 수 있습니다.

구성 파일은 $XDG_CONFIG_HOME/ponscli/config.json에 있는 플랫 JSON입니다 (~/.config/ponscli/config.json으로 폴백). 소유자만 쓸 수 있습니다.

PONS_PASSWORD와 PONS_PRIVATE_KEY는 환경 변수에서 읽히지만 의도적으로 구성 키가 아닙니다. 둘 다 config list가 출력하고 사용자가 이슈 보고에 붙여 넣는 파일에 들어가면 안 되기 때문입니다.

아키텍처

모든 결정과 그 배경 측정값을 담은 전체 문서는 docs/architecture/ponscli.md입니다. 간단히 요약하면:

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

두 프런트 엔드는 모두 src/core/를 감싼 셸입니다. 그래서 pons-mcp는 두 번째 구현체가 아니라 래퍼입니다.

요청 라우팅 방식

티어 1은 무료 엔드포인트를 라운드로빈 방식으로 순회합니다. 티어 2는 모든 티어 1 후보가 시도된 뒤에만 도달하는 유료 엔드포인트입니다. 모든 규칙은 범용 재시도 정책이 아니라 이 체인의 자체 엔드포인트를 상대로 한 측정에서 비롯됩니다. 일상에서 가장 중요한 규칙은 다음과 같습니다:

• 리버트는 실패가 아니라 답변입니다. 모든 엔드포인트에서 재시도된 후 유료 티어로 승격되는 대신, 리버트는 바로 사용자에게 돌아갑니다.

• 속도 제한은 엔드포인트를 1시간이 아니라 30초 동안 대기시킵니다. 무료 엔드포인트는 토큰 버킷입니다. 오래 대기시키면 스로틀링이 초래한 것보다 더 많은 가용성을 잃습니다.

• 쓰기는 절대 라운드로빈하지 않습니다. 한 노드에서 가져온 nonce를 다른 노드에 브로드캐스트하면 nonce too low가 되므로, 트랜잭션은 단일 엔드포인트에 고정됩니다.

• eth_chainId는 상태 점검이 아닙니다. 어떤 공개 엔드포인트는 다른 어떤 곳보다 빠르게 응답한 다음 eth_call을 거부합니다. pons doctor가 바로 이 이유로 실제 호출로 프로브합니다.

ABI

src/abi/는 생성되어 커밋되므로 CLI는 오프라인에서도 동작하며, 인터페이스 변경은 검토 가능한 diff로 나타납니다.

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

각 파일에는 ABI의 출처와 일치가 어떻게 입증되었는지가 기록되어 있습니다. 계약이 서로 다르기 때문에 출처 클래스는 네 가지입니다:

한 파일은 손으로 작성됩니다: erc20Errors.ts는 타사 견적 자산이 리버트할 때의 오류를 담고 있습니다. 견적 자산은 다른 누군가의 토큰이며, 승인된 스물세 개를 모두 포괄하는 단일 ABI는 없습니다. 이 오류들이 없으면 USDG 런치에서 가장 흔한 실패가 설명할 수 없는 4바이트로 출력됩니다.

에이전트용

전체 가이드: docs/agents.md.

pons-mcp는 이 패키지에 두 번째 바이너리로 포함되며 CLI가 사용하는 동일한 core/를 호출합니다.

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

도구는 여섯 가지입니다: pons_info, pons_pairs, pons_plan_buy, pons_plan_sell, pons_transaction, pons_endpoints.

서버는 서명할 수 없으며, 그렇게 만드는 플래그도 없습니다. 서버는 체인을 읽고 서명되지 않은 트랜잭션을 구성합니다. 전송은 사람이 합니다. 이것이 보안 모델의 전부이며, 서버를 모델 옆에 계속 실행해 두어도 안전한 이유입니다. 혼란에 빠진 에이전트가 할 수 있는 최악의 일은 나쁜 가격을 견적해 주는 것이지, 돈을 쓰는 것이 아닙니다.

답변은 기본 단위로 반환됩니다. 모델은 50000000000000000에 대해서는 정확한 산술을 할 수 있지만 0.05에 대해서는 할 수 없기 때문입니다.

대신 CLI를 셸로 호출하는 에이전트의 경우, stdout이 터미널이 아니면 --json이 이미 기본값이며, 인자 실수 시 실패한 명령의 사용법 줄이 함께 전달되므로 호출자가 스스로 수정할 수 있습니다:

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

에이전틱 코딩

이 저장소에는 자체 에이전트 구성이 포함되어 있습니다. CLAUDE.md는 프로젝트 브리프이며, Codex, Cursor, Copilot 등을 위해 AGENTS.md가 이 파일에 심볼릭 링크되어 있습니다.

테스트

npm run typecheck
npm run lint
npm test
npm run build

테스트 스위트는 완전히 오프라인입니다. 모든 테스트는 실제 명령 인터페이스를 test/fakeChain.ts를 상대로 구동합니다. test/fakeChain.ts는 주소 + ABI + 함수 → 결과 테이블로 Multicall3와 eth_getLogs도 제공하므로, 실제 경로가 사용하는 것과 동일한 디코딩 및 집계가 테스트됩니다.

두 가지 검사는 네트워크에 도달하며 의도적으로 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

로컬 노드 없이 시퀀스

시뮬레이션은 하나의 블록에 대한 하나의 호출만 증명합니다. 승인이 처리되고 다음 블록에서 매도가 성공하는 것, 또는 런치가 확정되고 런치가 만든 곡선을 한 블록 뒤에 구매할 수 있는 것은 증명하지 못합니다. 바로 그런 실패가 사용자에게 도달합니다.

Robinhood Chain은 eth_simulateV1을 지원합니다. 이 메서드는 라이브 메인넷 상태를 대상으로 여러 호출로 구성된 여러 블록을 실행하며, 상태는 모든 블록에 걸쳐 유지됩니다. npm run test:sequence는 이를 사용해 런치의 전체 수명(생성, 거래, 졸업 임계값 통과, Uniswap V4 풀에 시딩)을 포함한 여섯 가지 시퀀스를 증명합니다. 로컬 노드도 Foundry도 없으며 아무것도 소비되지 않습니다.

모든 시퀀스에는 반드시 실패해야 하는 대조군이 포함됩니다. 그것이 없으면 상태 재정의가 시퀀스가 증명하는 것처럼 보이는 작업을 실제로 수행하고 있을 수 있습니다.

의도적으로 실제 돈 쓰기

scripts/mainnet-e2e.sh는 메인넷에서 토큰을 런칭하고, 구매하고, 판매하고, 수수료를 청구합니다. 실제로요. 시퀀스는 위 검사에서 이미 다루어지므로, 이것이 추가하는 것은 시뮬레이션이 할 수 없는 단 한 가지입니다: 실제 키로 서명되고 실제 멤풀이 수락하며 디코딩할 실제 영수증이 있는 실제 트랜잭션. 이 스크립트는 명시하지 않는 한 꺼져 있고, 모든 트랜잭션 전에 확인을 요청하며, CI에서 절대 실행되어서는 안 됩니다.

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

종료 코드

스크립트와 에이전트는 문장을 파싱하지 않고도 결과에 따라 분기할 수 있습니다.

--json 모드에서 실패는 {"ok": false, "error": {...}}를 stderr에 기록하며 stdout에는 절대 기록하지 않습니다. 따라서 파이프는 결과만 전달합니다.

기여

CONTRIBUTING.md를 참조하고, 공개 이슈가 되어서는 안 되는 사항은 SECURITY.md를 참조하세요. 짧게 요약하면: 위의 네 가지 검사를 실행하고, 새 동작은 src/core/에 유지하며, 프로토콜에 대한 어떤 주장이든 기록하기 전에 메인넷에서 검증하세요. 계약 소스는 중요한 여러 곳에서 최신 상태가 아닙니다.

소개

TypeScript로 viem 위에서 처음부터 작성되었습니다. 어떤 저장소에서도 소스를 복사하지 않았습니다. 명령 인터페이스는 chainstacklabs/pumpfun-cli의 동작 맵에서 파생되었고, RPC 정책은 이 체인의 자체 엔드포인트에 대한 측정에서 파생되었습니다.

Pons 자체는 ponsfamily.com에 있습니다: 런칭과 탐색을 위한 웹 클라이언트, 그 분석, 그리고 그 문서. 이 CLI는 그 일부가 아니며, 그로부터 보증받지도 않았고, 다른 누구나 접근할 수 있는 동일한 공개 계약과 통신합니다.

라이선스

MIT. LICENSE를 참조하세요.