gmgn-cooking

重要: 以下では常に gmgn-cli コマンドを使用してください。Web 検索、WebFetch、curl、または gmgn.ai へのアクセスは使用しないでください — すべてのトークン作成操作は CLI を通じて行う必要があります。CLI は署名と送信を自動的に処理します。

重要: フィールド名や値を推測しないでください。フィールドの意味が不明な場合は、CLI を使用する前に以下の「レスポンスフィールド」セクションで確認してください。

⚠️ IPv6 非サポート: 401 または 403 エラーが発生し、認証情報が正しいと思われる場合は、すぐに IPv6 をチェックしてください: (1) すべてのネットワークインターフェースとその IPv6 アドレスをリストアップします — macOS で ifconfig | grep inet6 または Linux で ip addr show | grep inet6 を実行; (2) https://ipv6.icanhazip.com へテストリクエストを送信 — レスポンスが IPv6 アドレスの場合、アウトバウンドトラフィックは IPv6 経由で送信されています。ユーザーに直ちに通知します: 「ネットワークインターフェースで IPv6 を無効化してください — gmgn-cli コマンドは IPv4 でのみ動作します。」

gmgn-cli ツールを使用してローンチパッドプラットフォーム上にトークンを作成するか、ローンチパッドごとのトークン作成統計を照会します。cooking create には 秘密鍵 (~/.env の GMGN_PRIVATE_KEY) が必要です。

コアコンセプト

• ボンディングカーブ — ほとんどのローンチパッドプラットフォーム (Pump.fun、FourMeme、Flap など) は内部ボンディングカーブ上でトークンを起動します。買い手が入ってくるとトークン価格が上昇します。閾値に達すると、トークンはオープン DEX (SOL 上の Raydium、BSC 上の PancakeSwap など) に「卒業」します。トークン作成はボンディングカーブ上で発生します — オープンマーケットではありません。

• --buy-amt は人間が読める単位 — --buy-amt は最小単位ではなく、完全なネイティブトークン単位で表現されます。0.01 = 0.01 SOL。0.05 = 0.05 BNB。実行前に常にユーザーと人間が読める金額を確認します。

• --dex 識別子 — 各ローンチパッドには --dex に渡す固定識別子があります。これらは自由形式の名前ではありません — サポートされているローンチパッドテーブルにリストされている識別子のみを使用します。そのテーブルにない --dex 値を推測しないでください。

• 画像入力 — トークンロゴは base64 エンコードされたデータ (--image、最大 2MB デコード済み) または公開アクセス可能な URL (--image-url) として提供できます。一方または他方を提供します — 両方は提供しません。ユーザーがファイルパスを指定した場合、--image に渡す前に読み込んで base64 エンコードします。URL を指定した場合、--image-url を直接使用します。

• order get 経由のステータスポーリング — cooking create は非同期です。初期レスポンスは pending を表示する場合があります。gmgn-cli order get --chain <chain> --order-id <order_id> を使用してポーリングし、confirmed になるまで待機します。新しいトークンのコントラクトアドレスは初期作成レスポンスではなく、order get レスポンスの output_token フィールドにあります。

• 重要な認証 — cooking create には GMGN_API_KEY と GMGN_PRIVATE_KEY の両方が必要です。秘密鍵がマシンを離れることはありません — CLI はローカル署名にのみ使用します。cooking stats は通常の認証を使用します (API キーのみ)。

• スリップページ — 初期買いはトークン作成と同じトランザクションの一部として実行されます。スリップページはその買いに適用されます。--buy-amt が設定されている場合、--slippage (小数点、例: 0.01 = 1%) または --auto-slippage を使用します。どちらか一方が必須です。

金融リスク通知

このスキルは実際の、取り消せないブロックチェーン取引を実行します。

• すべての cooking create コマンドは、オンチェーントークンコントラクトをデプロイし、実際の資金 (初期買い額) を消費します。
• トークンデプロイがオンチェーンで確認されると、取り消すことはできません。
• AI エージェントは作成を自動実行してはいけません — 例外なく毎回明示的なユーザー確認が必要です。
• このスキルは、消費する用意のある資金でのみ使用します。初期買い額は払い戻せません。

サブコマンド

サブコマンド	説明
cooking stats	ローンチパッドプラットフォームでグループ化されたトークン作成数統計を取得します (通常認証)
cooking create	ローンチパッドプラットフォーム上に新しいトークンをデプロイします (秘密鍵が必須)

サポートされるチェーン

sol / bsc / base / eth / ton

チェーン別サポートローンチパッド

チェーン	--dex の値
sol	pump / raydium / bonk / bags / memoo / letsbonk / bonkers
bsc	pancakeswap / flap / fourmeme
base	clanker / flaunch / baseapp / basememe / zora / virtuals_v2

ユーザーがプラットフォームを日常的に名付ける場合 (例: "pump.fun"、"four.meme"、"PancakeSwap")、コマンドを実行する前にこのテーブルの正しい --dex 識別子にマップします。

前提条件

• cooking stats: GMGN_API_KEY のみ必須
• cooking create: GMGN_API_KEY と GMGN_PRIVATE_KEY の両方が ~/.config/gmgn/.env で設定される必要があります。秘密鍵は API キーにバインドされたウォレットに対応する必要があります。
• gmgn-cli がグローバルにインストールされている — 不足している場合は以下を実行します: npm install -g gmgn-cli

重要 — 認証情報ルックアップ順序: gmgn-cli は最初に ~/.config/gmgn/.env を読み込み、次に現在の作業ディレクトリ (プロジェクトレベルがグローバルをオーバーライド) で見つかった .env をオーバーレイします。認証情報が不足または正しくない場合、ワークスペースディレクトリの .env が ~/.config/gmgn/.env をシャドウしているかどうかを確認します:

ls -la .env 2>/dev/null && echo "警告: ローカル .env は ~/.config/gmgn/.env をオーバーライドしています"

ローカル .env が存在するが GMGN_API_KEY / GMGN_PRIVATE_KEY を欠いている場合、そのファイルに追加するか、グローバル設定が使用されるようにそれを削除します。

レート制限処理

すべての cooking ルートは rate=20 および capacity=20 を備えた GMGN の漏れバケットリミッターを通過します。持続スループットは大体 20 ÷ weight リクエスト/秒です。

コマンド	ウェイト
cooking create	5
cooking stats	1

リクエストが 429 を返した場合:

• レスポンスヘッダーから X-RateLimit-Reset を読み取ります — リミットがリセットされるときの Unix タイムスタンプ。
• レスポンスボディに reset_at が含まれている場合 (例: {"code":429,"error":"RATE_LIMIT_BANNED","message":"...","reset_at":1775184222})、reset_at を抽出します — バンが解除されるときの Unix タイムスタンプです (通常 5 分)。ローカル時刻に変換し、ユーザーに正確に再試行できるのはいつかを伝えます。
• cooking create は実際のトランザクションです: 429 後にループまたは自動再送信しないでください。リセット時刻まで待機し、再試行する前に再度確認を求めます。
• RATE_LIMIT_EXCEEDED または RATE_LIMIT_BANNED の場合、クールダウン中の繰り返されたリクエストはバンを 5 秒ずつ延長し、最大 5 分まで延長します。

初回セットアップ (認証情報が設定されていない場合):

1. キーペアを生成し、公開鍵をユーザーに表示します:

   openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
     openssl pkey -in /tmp/gmgn_private.pem -pubout 2>/dev/null
   

   ユーザーに伝えます: 「これは Ed25519 公開鍵です。https://gmgn.ai/ai に移動し、API キー作成フォームに貼り付けます (swap/cooking 機能を有効化)、その後ページに表示される API キー値を送信してください。」

2. ユーザーの API キーを待機し、両方の認証情報を設定します:

   mkdir -p ~/.config/gmgn
   echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
   echo 'GMGN_PRIVATE_KEY="<pem_content_from_step_1>"' >> ~/.config/gmgn/.env
   chmod 600 ~/.config/gmgn/.env
   

認証情報モデル

• GMGN_PRIVATE_KEY は ローカルメッセージ署名 専用に使用されます — 秘密鍵はマシンを離れません。CLI はプロセス内で Ed25519 署名を計算し、X-Signature リクエストヘッダーで base64 エンコードされた結果のみを送信します。
• GMGN_API_KEY は HTTPS 上の X-APIKEY ヘッダーで送信されます。
• どちらの認証情報もコマンドライン引数として渡されることはありません。

cooking stats 使用法

gmgn-cli cooking stats [--raw]

cooking stats レスポンスフィールド

フィールド	型	説明
launchpad	string	ローンチパッド識別子 (例: pump、raydium、pancakeswap)
token_count	int	そのローンチパッドで GMGN 経由で作成されたトークン数

cooking create パラメータ

パラメータ	必須	説明
--chain	はい	チェーン: sol / bsc / base / eth / ton
--dex	はい	ローンチパッドプラットフォーム識別子 — サポートされているローンチパッドテーブルを参照してください。この値を推測しないでください。
--from	はい	ウォレットアドレス (API キーバインディングに一致する必要があります)
--name	はい	トークン完全名 (例: Doge Killer)
--symbol	はい	トークンティッカーシンボル (例: DOGEK)
--description	いいえ	トークンの説明 / プロジェクトピッチ
--buy-amt	はい	人間が読める ネイティブトークン単位での初期買い額 (例: 0.01 = 0.01 SOL)。これは最小単位ではありません。
--image	いいえ*	トークンロゴを base64 エンコード されたデータとして (最大 2MB デコード済み)。--image-url と相互排他的です。どちらか一方が必須です。
--image-url	いいえ*	トークンロゴを公開アクセス可能な URL として。--image と相互排他的です。どちらか一方が必須です。
--slippage	いいえ*	スリップページ許容度、例: 0.01 = 1%。--auto-slippage と相互排他的 — 一方または他方を提供します。
--auto-slippage	いいえ*	自動スリップページを有効化します。--slippage と相互排他的。
--website	いいえ	プロジェクト Web サイト URL
--twitter	いいえ	Twitter / X URL
--telegram	いいえ	Telegram グループ URL
--priority-fee	いいえ	優先度フィー (SOL のみ、≥ 0.0001 SOL)
--tip-fee	いいえ	チップフィー (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB; ETH/BASE では無視)
--gas-price	いいえ	ガス価格 (wei 単位、EVM チェーン)
--anti-mev	いいえ	アンチ MEV 保護を有効化

* --image または --image-url: 正確に一つを提供します。--slippage または --auto-slippage: 正確に一つを提供します。

cooking create レスポンスフィールド

フィールド	型	説明
status	string	pending / confirmed / failed
hash	string	トランザクションハッシュ (pending 中は空の場合があります)
order_id	string	オーダー ID — gmgn-cli order get に渡して最終ステータスをポーリングします
error_code	string	失敗時のエラーコード
error_status	string	失敗時のエラー説明

ステータスポーリング

トークン作成は 非同期 です。初期 cooking create レスポンスが status: pending を表示する場合:

1. 2 秒 ごと、最大 30 秒 まで gmgn-cli order get でポーリングします:

   gmgn-cli order get --chain <chain> --order-id <order_id>
   

2. 新しいトークンのコントラクト / ミントアドレスは order get レスポンスの report.output_token フィールド内にあります (state = 30 および status = "successful" のときのみ存在) — cooking create によって直接返されません。
3. status が confirmed、failed、または expired になったらポーリングを停止します。
4. confirmed 時: output_token をトークンアドレスとして表示し、ブロックエクスプローラーリンクを含めます。
5. failed / expired 時: error_status を報告し、自動的に再試行しません。

使用例

# ローンチパッドごとのトークン作成統計を取得
gmgn-cli cooking stats

# Pump.fun (SOL) 上にトークンを作成 — URL 画像付き
gmgn-cli cooking create \
  --chain sol \
  --dex pump \
  --from <wallet_address> \
  --name "My Token" \
  --symbol MAT \
  --buy-amt 0.01 \
  --image-url https://example.com/logo.png \
  --slippage 0.01 \
  --priority-fee 0.001

# PancakeSwap (BSC) 上にトークンを作成 — URL 画像とソーシャルリンク付き
gmgn-cli cooking create \
  --chain bsc \
  --dex pancakeswap \
  --from <wallet_address> \
  --name "BSC Token" \
  --symbol BSCT \
  --buy-amt 0.05 \
  --image-url https://example.com/logo.png \
  --slippage 0.02 \
  --gas-price 5000000000 \
  --website https://mytoken.io \
  --twitter https://twitter.com/mytoken

# FourMeme (BSC) 上にトークンを作成 — ローカルファイルから base64 画像を使用
gmgn-cli cooking create \
  --chain bsc \
  --dex fourmeme \
  --from <wallet_address> \
  --name "Four Token" \
  --symbol FOUR \
  --buy-amt 0.05 \
  --image "$(base64 -i /path/to/logo.png)" \
  --auto-slippage

# letsbonk (SOL) 上にトークンを作成
gmgn-cli cooking create \
  --chain sol \
  --dex letsbonk \
  --from <wallet_address> \
  --name "Bonk Token" \
  --symbol BNKT \
  --buy-amt 0.01 \
  --image-url https://example.com/logo.png \
  --auto-slippage \
  --anti-mev

出力フォーマット

作成前確認

すべての cooking create の前に、このサマリーを提示し、明示的なユーザー確認を待ちます:

⚠️ トークン作成確認が必要です

チェーン:      {chain}
プラットフォーム: {--dex} (例: pump / fourmeme)
ウォレット:    {--from}
トークン名:    {--name}
シンボル:      {--symbol}
初期買い:      {--buy-amt} {ネイティブ通貨} (例: 0.01 SOL)
スリップページ: {--slippage}% (または「オート」)
画像:          {--image-url または「base64 提供」}
ソーシャル:    {twitter / telegram / website (提供されている場合)}

「confirm」と返信してこのトークンをデプロイします。このアクションは取り消せません。

作成後レシート

ポーリングが正常なデプロイを確認した後:

✅ トークンが作成されました

トークン:  {--name} ({--symbol})
アドレス:  {order get からの output_token}
チェーン:  {chain}
プラットフォーム: {--dex}
Tx:       {ハッシュのエクスプローラーリンク}
オーダー ID: {order_id}

ブロックエクスプローラーリンク:

チェーン	エクスプローラー
sol	https://solscan.io/tx/<hash>
bsc	https://bscscan.com/tx/<hash>
base	https://basescan.org/tx/<hash>
eth	https://etherscan.io/tx/<hash>

ガイド付きローンチフロー

ユーザーがトークンをローンチ / 作成 / デプロイしたいと言う場合で、必須情報をすべて提供していない場合は、情報を 一度に必須フィールド一つずつ 収集します — 複数の必須フィールドを一つの質問に束ねないでください。ユーザーはラベル付きリストではなく、単一の値で返信できるべきです。

各必須フィールドを短く直接的な質問として求めます。次に進む前に回答を待ちます。すべての必須フィールドが収集された後、オプションフィールドは一つの質問にグループ化されます。

ステップ 1 — チェーン & プラットフォーム

質問: 「どのチェーンとプラットフォーム?」

オプションを簡潔に表示します:

チェーン	プラットフォーム	--dex
Solana	Pump.fun	pump
Solana	letsbonk	letsbonk
Solana	Raydium	raydium
Solana	BAGS	bags
Solana	Memoo	memoo
Solana	Bonkers	bonkers
BSC	FourMeme	fourmeme
BSC	PancakeSwap	pancakeswap
BSC	Flap	flap
Base	Clanker	clanker
Base	Zora	zora
Base	Flaunch	flaunch
Base	Virtuals	virtuals_v2

ユーザーが確信を持たない場合は、推奨します: Pump.fun (SOL) または FourMeme (BSC)。

ステップ 2 — トークン名

質問: 「トークン名?」

ユーザーの返信を待ちます (例: Doge Killer)。

ステップ 3 — トークンシンボル

質問: 「ティッカーシンボル?」

ユーザーの返信を待ちます (例: DOGEK)。通常 3 ~ 8 文字の大文字です。

ステップ 4 — ロゴ

質問: 「ロゴ画像? (ファイルパスまたは URL — ロゴなしで起動するためにスキップ)」

• ファイルパス → 静かに base64 -i <path> を実行し、結果を --image に渡します。ユーザーに「base64」について言及しないでください。
• URL → --image-url を直接使用します。
• スキップ / なし → ロゴなしで進めます。ほとんどのプラットフォームはこれを受け入れますが、可視性が低下します。

ステップ 5 — 初期買い額

質問: 「初期買い用に {SOL / BNB / ETH} いくら?」

ユーザーの回答を --buy-amt に直接渡します — すでに完全なトークン単位です (例: 0.01 = 0.01 SOL)。ラムポートまたは wei に変換しないでください。

ステップ 6 — オプション詳細 (単一の質問)

一つのメッセージですべてのオプションフィールドを一緒に質問します:

「オプション機能?他に何か必要なものはスキップできます」

• 説明 — ローンチパッドに表示されるワンラインピッチ
• Twitter — Twitter / X URL
• Telegram — Telegram グループ URL
• Web サイト — プロジェクト Web サイト URL

ユーザーは持っているもののみで返信するか、進めるために「skip」または「none」と言うことができます。

ステップ 7 — 確認と実行

すべての情報が収集されたら、作成前確認サマリー (出力フォーマットセクション参照) を提示し、実行前にユーザーから「confirm」の返信を受け取ります。

---

実行ガイドライン

• [必須] 作成前確認 — cooking create を実行する前に、上記の完全なサマリーを提示し、ユーザーから明示的な「confirm」を受け取ります。例外なし。自動作成しないでください。
• [必須] --dex 検証 — 実行前に、ユーザーが名付けたプラットフォームをサポートされているローンチパッドテーブルで検索し、正しい --dex 識別子に解決します。推測したり、自由形式のプラットフォーム名を渡したりしないでください。チェーン/プラットフォーム組み合わせがテーブルにない場合、サポートされていないとユーザーに伝えます。
• スリップページ要件 — --slippage または --auto-slippage のどちらかを提供する必要があります。ユーザーが指定しなかった場合、揮発性の新しいトークンの場合は --auto-slippage を提案するか、好みを求めます。
• 画像処理 — ユーザーがファイルパスを提供した場合、base64 -i <path> を実行し、結果を --image に渡します。URL を提供した場合、--image-url を使用します。どちらも提供されていない場合、確認を構築する前に質問します — ほとんどのプラットフォームはロゴが必須です。
• アドレス検証 — 送信前に --from ウォレットアドレス形式を検証します:
  • sol: base58、32 ~ 44 文字
  • bsc / base / eth: 0x + 40 16 進数字
• チェーン-ウォレット互換性 — SOL アドレスは EVM チェーンと互換性がなく、その逆も同様です。アドレス形式がチェーンと一致しない場合、ユーザーに警告して中止します。
• オーダーポーリング — cooking create 後、status が pending の場合、order get を 2 秒ごとに最大 30 秒までポーリングします。トークンアドレスは output_token にあります。status が confirmed になるまで成功を報告しません。
• 認証情報の機密性 — GMGN_API_KEY と GMGN_PRIVATE_KEY は実際のトランザクションを実行できます。これらの値を記録、表示、または公開しないでください。

注記

• cooking create は 重要な認証 を使用します (API キー + 署名) — CLI は署名を自動的に処理します。
• cooking stats は通常の認証を使用します (API キーのみ — 秘密鍵は不要です)。
• 新しいトークンのミントアドレスは初期 cooking create レスポンスではなく、gmgn-cli order get からの output_token にあります。
• --raw をコマンドに使用して、単一行の JSON を取得し、さらに処理します。

リファレンス

スキル	説明
gmgn-swap	トークン作成ステータスをポーリングするために使用される order get コマンドを含みます
gmgn-token	トークンセキュリティチェック、情報、ホルダー、トレーダー — ローンチ後にトークンを監視するのに便利です
gmgn-market	ボンディングカーブの進行を追跡するための market trenches; トークンが人気を得ているかどうかを確認するための market trending
gmgn-track	スマートマネーと KOL トレード追跡 — ローンチ後にスマートウォレットがトークンを購入しているかどうかを監視します
gmgn-portfolio	ウォレット保有物と P&L — --buy-amt を決定する前にウォレットバランスを確認します