four-meme-ai について
four-meme-aiは、BSC上でfourmeme CLIを使うためのスキルで、トークンの照会、見積もり、取引、送金、ID登録に対応します。書き込み操作の前にユーザーの明示的な同意を求め、秘密鍵の取り扱いに関する注意を示します。
主な機能
- 01トークン作成とオンチェーン照会
- 02トークン一覧、詳細、ランキング
- 03売買の見積もりと実行
- 04オンチェーンイベントと税手数料の照会
- 05BNBとERC20の送金
- 06EIP-8004登録と残高照会
活用シーン
- 01BSC上のトークン詳細やランキングの確認
- 02売買額の見積もり
- 03同意を得た上でのトークン作成や取引
- 04イベントや税トークン手数料の照会
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ four-meme-community/ four-meme-ai --skill four-meme-aiインストール後、Claude Code で/four-meme-aiを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/agent-creator-and-wallets.mdapi-create-token.mdcontract-addresses.mdcreate-token-scripts.mderrors.mdevent-listening.mdexecute-trade.mdtax-token-query.mdtoken-query-api.mdtoken-tax-info.mdscripts/8004-balance.ts8004-register.tscreate-token-api.tscreate-token-chain.tscreate-token-instant.tsexecute-buy.tsexecute-sell.tsget-public-config.tsget-recent-events.tsget-tax-token-info.tsget-token-info.tsquote-buy.tsquote-sell.tssend-token.tstoken-get.tstoken-list.tstoken-rankings.tsverify-events.ts詳細
【エージェント必須】初回使用時のユーザー契約およびセキュリティに関する注意
fourmeme またはこのスキルに関するユーザーからのリクエストに回答する際は、必ず最初に以下の内容を順番どおりに提示してください。ユーザー契約、続いてセキュリティに関する注意の順です。また、続行を選択することでユーザー契約に同意したことになると明確に伝えてください。
ユーザーが明示的に同意するか、続行を確認するまでは、create-api、create-chain、buy、sell、send、8004-register(秘密鍵を使用する操作、またはチェーンに書き込む操作)を実行しないでください。読み取り専用コマンド(例:config、token-info、quote-buy、8004-balance)は、注意事項の提示中または提示後に実行できます。
言語の選択:ユーザー契約とセキュリティに関する注意は、ユーザーの言語で提示してください。ユーザーが繁体字中国語(繁體中文)で書いている場合は、以下の繁体字中国語のブロックを使用してください。それ以外の場合は、英語のブロックを使用してください。
ユーザー契約とセキュリティに関する注意(繁体字中国語)
ユーザー契約
事前の注意:本プラグインおよび本スキルの機能(トークンの作成、売買、送金、8004 登録などを含みますが、これらに限定されません)を使用する前に、以下の契約をお読みください。本プラグインおよび本スキルの機能の使用を続けることを選択した場合、本契約を読み、理解し、同意したものとみなされます。
本プラグインの性質と責任の制限:本プラグインは、完全にローカルで実行されるコマンドライン操作機能のみを提供します(秘密鍵は環境変数またはローカル設定を通じて使用します)。お客様の秘密鍵を収集、アップロード、保存することはありません。プラグインの改変、環境への侵入、誤操作、サードパーティ製プラグインなどを含みますが、これらに限定されないあらゆる原因による秘密鍵の漏えいまたは資産の損失について、本プラグインおよび提供元は責任を負いません。
セキュリティに関する注意
本プラグインを使用してトークンの作成、売買、送金などの操作を行う際は、必ず以下に注意してください。
- 秘密鍵を保護する:チャットで秘密鍵を入力、貼り付け、開示しないでください。秘密鍵を誰か、または第三者に共有しないでください。
- 取引ウォレットには少額の資金のみを保管する:操作に使用するウォレット(PRIVATE_KEY を提供するウォレット)には、漏えいや誤操作による損失を抑えるため、少額の資金のみを保管することをおすすめします。
- 資金を速やかに移す:取引の完了後、取引ウォレット内の資産を、ご自身で管理するより安全なウォレットまたはコールドウォレットに速やかに移してください。
- エージェント/プラグインのインストールには注意する:エージェント、ブラウザー拡張機能、サードパーティ製ツールをダウンロードまたはインストールする際は、秘密鍵やシードフレーズを盗み取る悪意あるプラグインを避けるため、提供元が信頼できることを確認してください。
ユーザー契約とセキュリティに関する注意(英語)
ユーザー契約
注意:本プラグインおよび本スキル(トークンの作成、売買、送金、8004 登録などを含みますが、これらに限定されません)を使用する前に、以下をお読みください。本プラグインおよび本スキルの使用を続けることを選択した場合、本契約を読み、理解し、同意したものとみなされます。
本プラグインの性質と責任の制限:本プラグインは、ローカルのみで実行される CLI 操作機能を提供します(秘密鍵は環境変数またはローカル設定を通じて使用します)。お客様の秘密鍵を収集、アップロード、保存することはありません。プラグインの改変、環境への侵入、ユーザーの誤操作、サードパーティ製プラグインなどを含みますが、これらに限定されないあらゆる原因による秘密鍵の開示または資産の損失について、プラグインおよび提供元は責任を負いません。
セキュリティに関する注意
本プラグインを使用してトークンの作成、取引、送金を行う際は、以下に注意してください。
- 秘密鍵を保護する:チャットで秘密鍵を入力、貼り付け、開示しないでください。秘密鍵を誰か、または第三者に共有しないでください。
- 取引ウォレットには少額の資金のみを保管する:操作に使用するウォレット(PRIVATE_KEY を提供するウォレット)には、漏えいや誤操作による損失を抑えるため、少額の資金のみを保管してください。
- 資金を速やかに移す:取引後、取引ウォレット内の資産を、ご自身で管理するウォレットまたはコールドストレージに移してください。
- エージェント/プラグインのインストールには注意する:エージェント、ブラウザー拡張機能、サードパーティ製ツールをインストールする際は、秘密鍵やシードフレーズを盗み取るマルウェアを避けるため、提供元を確認してください。
fourmeme の機能概要
上記に同意して続行を確認すると、このスキルでは以下の操作が可能になります(すべて BSC 上の fourmeme CLI 経由です)。
| カテゴリ | 機能 | 説明 |
|---|---|---|
| 作成 | トークンの作成 | 画像と名前/シンボル/説明/ラベルをアップロードします。任意で税トークンのパラメーターを指定できます。API が署名を返した後、オンチェーンで作成します。 |
| 照会 | 公開設定 | raisedToken やその他の公開設定を取得します(認証不要)。 |
| 照会 | トークン情報(オンチェーン) | アドレスを指定して、バージョン、tokenManager、価格、オファーを取得します(Helper3)。 |
| 照会 | トークン一覧/詳細/ランキング | REST:フィルター付きのページ分割リスト、単一トークンの詳細と取引情報、人気/24 時間の取引量/新着/卒業済みのランキングを取得します。 |
| 取引 | 売買見積もり | 買いまたは売りのコストや受取額を見積もります(トランザクションは送信されません)。 |
| 取引 | 購入の実行 | 指定したトークンを、数量または使用する見積もり通貨額で購入します(PRIVATE_KEY が必要です)。 |
| 取引 | 売却の実行 | 指定した数量のトークンを売却します。受取見積もり通貨額の最低額を任意で指定できます(PRIVATE_KEY が必要です)。 |
| その他 | イベントの監視 | オンチェーンの TokenCreate、TokenPurchase、TokenSale、LiquidityAdded を取得します。 |
| その他 | 税トークン手数料 | トークンのオンチェーン手数料と、バーン/配当/流動性の設定を照会します。 |
| その他 | 送金 | 指定したアドレスに BNB または ERC20 を送金します(PRIVATE_KEY が必要です)。 |
| その他 | EIP-8004 | 8004 ID NFT を登録し、アドレスごとの残高を照会します。 |
コマンドと引数については、以下の CLI (fourmeme) の表と各セクションを参照してください。
fourmeme CLI
BSC のみ対応しています。すべてのコマンドは JSON を出力します。
CLI (fourmeme)
インストール(必須): npm install -g @four-meme/four-meme-ai@latest。インストール後、fourmeme <command> [args] を実行します。ローカルインストールのみの場合は、プロジェクトのルートから npx fourmeme <command> [args] を使用します。使い方を確認するには、fourmeme --help を実行してください。
このスキルでは、トークン作成(API + チェーン)、売買見積もりと実行、トークン情報/一覧/ランキング、イベント監視、税トークン手数料の照会、送金、EIP-8004 ID NFT の登録と残高照会が可能です。コントラクトアドレス:references/contract-addresses.md。TokenManager V1 はサポートされていません。
PRIVATE_KEY と BSC_RPC_URL
OpenClaw を使用する場合
このスキルはメタデータで requires.env: ["PRIVATE_KEY"] と primaryEnv: "PRIVATE_KEY" を宣言しています。OpenClaw は、エージェントがこのスキルを有効にして実行される場合にのみ、これらを注入します(他のスキルからアクセスすることはできません)。
必要な手順:
- 秘密鍵を設定する:スキル管理ページで four-meme-ai スキルの apiKey(
primaryEnv: "PRIVATE_KEY"に対応)を設定するか、~/.openclaw/openclaw.jsonのskills.entries["four-meme-ai"].envにPRIVATE_KEYを設定します。必要に応じて、グローバル環境変数に BSC_RPC_URL を設定できます。 - このスキルを有効にする:エージェントまたはセッションで、four-meme-ai スキルが有効になっていることを確認してください。スキルが有効な場合にのみ、OpenClaw はプロセスに PRIVATE_KEY を注入します。有効でない場合、キーが見つからないため、作成/購入/売却/送金/8004 登録は失敗します。BSC_RPC_URL は省略可能です(メタデータ:
optionalEnv)。設定されていない場合、スクリプトはデフォルトの BSC RPC を使用します。
OpenClaw を使用しない場合(スタンドアロン)
npx fourmeme または node bin/fourmeme.cjs の実行時に利用できるよう、プロセス環境変数で PRIVATE_KEY と、必要に応じて BSC_RPC_URL を設定してください。
- .env ファイル:
fourmemeコマンドを実行するディレクトリ(つまり、プロジェクト/作業ディレクトリ)に.envファイルを配置します。例:/path/to/my-projectからfourmeme quote-buy ...を実行する場合は、/path/to/my-project/.envに配置します。CLI は現在の作業ディレクトリにある.envを自動的に読み込みます。PRIVATE_KEY=...やBSC_RPC_URL=...のような行を使用してください。.envをコミットしないでください。.gitignoreに追加してください。 - シェルでのエクスポート:
export PRIVATE_KEY=your_hex_keyとexport BSC_RPC_URL=https://bsc-dataseed.binance.org(または別の BSC RPC)を実行してから、npx fourmeme <command> ...を実行します。
宣言済みおよび任意の環境変数
- レジストリのメタデータで宣言(スキルが有効になると OpenClaw が注入):書き込み操作には PRIVATE_KEY が必須です。メタデータでの任意項目:BSC_RPC_URL(未設定の場合、スクリプトはデフォルトの BSC RPC にフォールバックします)。
- メタデータには含まれず、環境変数またはプロジェクトの
.envで設定可能:BSC_RPC_URL、CREATION_FEE_WEI(作成時に追加する BNB)、WEB_URL、TWITTER_URL、TELEGRAM_URL、PRE_SALE、FEE_PLAN、8004_NFT_ADDRESS / EIP8004_NFT_ADDRESS。署名に必要なのは PRIVATE_KEY のみです。それ以外はデフォルト値があるか、特定のコマンドでのみ使用されます(「Create token flow」、「EIP-8004」などを参照)。Tax token のパラメーターは CLI のみで指定します(--tax-options=または--tax-token --tax-fee-rate=...)。
実行とインストール
- 呼び出し:エージェントは fourmeme CLI 経由でのみコマンドを実行する必要があります:
fourmeme <command> [args]またはnpx fourmeme <command> [args](allowed-tools)。スクリプトやnpx tsxを直接呼び出さないでください。CLI のエントリポイント(bin/fourmeme.cjs)が適切なスクリプトを呼び出し、現在の作業ディレクトリから.envを読み込みます。
| 必要な操作 | コマンド | 用途 |
|---|---|---|
| 公開設定 | fourmeme config | raisedToken / config を取得します(認証不要) |
| トークン情報(オンチェーン) | fourmeme token-info <tokenAddress> | バージョン、tokenManager、価格、オファー(BSC Helper3) |
| トークン一覧(REST) | fourmeme token-list — POST /public/token/search;レガシーフラグ [--orderBy=] … とレガシーの `--queryMode=Binance | USD1(listTypeを推定)、または新しい[--type=] [--listType=] [--keyword=] [--tag=] [--status=] [--sort=] [--version=]` |
| トークン詳細(REST) | fourmeme token-get <tokenAddress> | トークンの詳細と取引情報(get/v2) |
| トークンランキング(REST) | `fourmeme token-rankings <orderBy | type> [--barType=…]` |
| 買い見積もり | fourmeme quote-buy <token> <amountWei> [fundsWei] | 見積もりのみ。トランザクションは実行しません |
| 売り見積もり | fourmeme quote-sell <token> <amountWei> | 見積もりのみ。トランザクションは実行しません |
| 買いを実行 | fourmeme buy <token> amount <amountWei> <maxFundsWei> | 固定数量を購入します(PRIVATE_KEY が必要) |
| 買いを実行 | fourmeme buy <token> funds <fundsWei> <minAmountWei> | 固定の見積もり額(例:BNB)を使用します(PRIVATE_KEY が必要) |
| 売りを実行 | fourmeme sell <token> <amountWei> [minFundsWei] | 売却します(PRIVATE_KEY が必要) |
| 送信 | fourmeme send <toAddress> <amountWei> [tokenAddress] | アドレスに BNB または ERC20 を送信します(PRIVATE_KEY が必要) |
| EIP-8004 登録 | fourmeme 8004-register <name> [imageUrl] [description] | 8004 identity NFT を登録します(PRIVATE_KEY が必要) |
| EIP-8004 照会 | fourmeme 8004-balance <ownerAddress> | 8004 NFT の残高を照会します(読み取り専用) |
| イベント | fourmeme events <fromBlock> [toBlock] | TokenCreate / Purchase / Sale / LiquidityAdded |
| Tax token 情報 | fourmeme tax-info <tokenAddress> | TaxToken の手数料/税設定 |
| 読み取り専用チェック | fourmeme verify | config と events を実行します(直近 50 ブロック) |
チェーン:BSC のみ(Arbitrum/Base はサポートされていません)。
トークンの作成(全フロー)
1. 必要な情報をユーザーに確認します(最初に必ず実施)
create-instant を呼び出す前に、エージェントは必ず以下の情報をユーザーに尋ね、確認する必要があります。
| 情報 | 必須 | 説明 |
|---|---|---|
| 画像パス(imagePath) | はい | ローカルのロゴパス。jpeg/png/gif/bmp/webp |
| トークン名(name) | はい | トークンの正式名称 |
| トークンシンボル(shortName) | はい | 例:MTK、DOGE |
| 説明(desc) | はい | トークンの説明文 |
| ラベル(label) | はい | 次のいずれか:Meme | AI | Defi | Games | Infra | De-Sci | Social | Depin | Charity | Others |
| 税トークンですか? | いいえ | はいの場合、tokenTaxInfo(feeRate、4つのレート、recipientAddress、minSharing)を確認します。詳細は下記の「tokenTaxInfo のパラメーター」を参照してください |
任意項目:--web-url=、--twitter-url=、--telegram-url=、--pre-sale=(BNB)、--fee-plan=。指定するか、デフォルト値のままにできます。
2. 技術的なフロー(create-instant が実行)
上記の情報を収集したら、次の順序で実行します(スクリプトまたは CLI が処理します)。
- nonce の取得 — accountAddress、verifyType、networkCode(BSC)を本文に含めて
POST /private/user/nonce/generateを実行します。 - ログイン — ウォレットで
You are sign in Meme {nonce}に署名し、POST /private/user/login/dexを実行して access_token を取得します。 - 画像のアップロード — access_token をヘッダーに含め、画像を本文として
POST /private/token/uploadを実行し、imgUrl を取得します。 - 作成 —
fourmeme create-instant --image= --name= --short-name= --desc= --label= [options]は、API による作成と BSC 上でのTokenManager2.createTokenの送信を1つのコマンドで実行します。
分割フロー(任意): ステップ4 — GET
/public/configで raisedToken を取得します。name、shortName、desc、imgUrl、label、raisedToken などを指定してPOST /private/token/createを実行し、createArg と signature を取得します。ステップ5 — BSC 上でTokenManager2.createToken(createArg, sign)を呼び出します。この分割フローにはfourmeme create-api、続いてfourmeme create-chainを使用します。
コマンド: fourmeme create-instant --image= --name= --short-name= --desc= --label= [options](推奨)。または分割して、fourmeme create-api ... の後に fourmeme create-chain <createArgHex> <signatureHex> を実行します。すべてのパラメーターについては fourmeme --help を参照してください。参照資料:api-create-token.md、create-token-scripts.md、token-tax-info.md。
税トークン
- オプション1:
--tax-options=<path>—{ "tokenTaxInfo": { ... } }を含む JSON ファイルのパスです。フィールドについては下記の「tokenTaxInfo のパラメーター」を参照してください。 - オプション2:CLI:
--tax-token --tax-fee-rate=5 --tax-burn-rate=0 --tax-divide-rate=0 --tax-liquidity-rate=100 --tax-recipient-rate=0 --tax-recipient-address= --tax-min-sharing=100000(burn+divide+liquidity+recipient = 100)。references/token-tax-info.md を参照してください。
tokenTaxInfo のパラメーター(税トークンで必須。JSON または CLI で指定):
| フィールド | 型 | 説明 | 制約 |
|---|---|---|---|
feeRate | number | 取引手数料率(%) | 次の値のみ:1、3、5、10 |
burnRate | number | バーンの配分率(%) | 次の3つの値との合計が100 |
divideRate | number | 配当の配分率(%) | 同上 |
liquidityRate | number | 流動性の配分率(%) | 同上 |
recipientRate | number | 受取人への配分率(%) | 使用しない場合は0 |
recipientAddress | string | 受取人アドレス | 使用しない場合は "" |
minSharing | number | 配当に必要な最小残高(ether 単位) | d×10ⁿ、n≥5、1≤d≤9。例:100000、1000000 |
例(手数料5%、バーン20%、配当30%、流動性40%、受取人10%):
{
"tokenTaxInfo": {
"feeRate": 5,
"burnRate": 20,
"divideRate": 30,
"liquidityRate": 40,
"recipientRate": 10,
"recipientAddress": "0x1234567890123456789012345678901234567890",
"minSharing": 100000
}
}
トークン情報
fourmeme token-info <tokenAddress>
オンチェーン照会(Helper3)。バージョン、tokenManager、価格、オファーなどを返します。
token-list / token-get / token-rankings(REST)
Four.meme REST API。Accept: application/json を使用します。ログインや Cookie は不要です。
トークン一覧(フィルター/ページネーション) — POST /public/token/search
fourmeme token-list [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]
fourmeme token-list [--type=HOT] [--listType=NOR] [--keyword=] [--tag=Meme,AI] [--status=PUBLISH|TRADE|ALL] [--sort=DESC] [--version=]
fourmeme token-list [--queryMode=Binance|USD1] [--listedPancake=true|false] (legacy shortcut; infers listType BIN/BIN_DEX or USD1/USD1_DEX)
旧仕様の listedPancake=false は status=PUBLISH に対応します。すべてのステータスが必要な場合は --status=ALL を使用してください。
トークン詳細と取引情報
fourmeme token-get <tokenAddress>
API:GET /private/token/get/v2?address=...
ランキング — POST /public/token/ranking
fourmeme token-rankings <orderBy|type> [--barType=HOUR24] [--pageSize=20] [--symbol=] [--version=] [--rankingKind=] [--minCap=] [--maxCap=] [--minVol=] [--maxVol=] [--minHold=] [--maxHold=] …
旧仕様の orderBy:Time → NEW | ProgressDesc | TradingDesc(出来高の期間は --barType で指定:HOUR24→VOL_DAY_1、HOUR4、HOUR1、MIN30、MIN5)| Hot | Graduated → DEX。API の type を直接渡すこともできます(例:VOL_DAY_1、CAP、BURN)。JSON を出力します。
quote-buy / quote-sell(見積もりのみ。トランザクションは実行しません)
fourmeme quote-buy <tokenAddress> <amountWei> [fundsWei]
fourmeme quote-sell <tokenAddress> <amountWei>
- amountWei:トークンの数量です(見積額で購入する場合は 0 を使用します)。fundsWei:使用する見積額です(トークン数量で購入する場合は省略するか、0 を指定します)。
buy / sell(実行。PRIVATE_KEY が必要です)
購入(次のいずれか):
- 数量指定:
fourmeme buy <token> amount <amountWei> <maxFundsWei>(最大 maxFundsWei を使用して amountWei のトークンを購入します)。 - 資金指定:
fourmeme buy <token> funds <fundsWei> <minAmountWei>(fundsWei の見積額を使用して、最低 minAmountWei のトークンを受け取ります)。
売却:スクリプトが approve の後に売却を実行します。
fourmeme sell <tokenAddress> <amountWei> [minFundsWei]
- minFundsWei は省略可能です(スリッページ:受け取る見積額の最小値)。V2 トークンのみ対応しています。
send(BNB または ERC20 をアドレスに送金)
現在のウォレット(PRIVATE_KEY)から指定したアドレス(BSC)へネイティブ BNBまたはERC20を送金します。
fourmeme send <toAddress> <amountWei> [tokenAddress]
| 引数 | 説明 |
|---|---|
toAddress | 受取人のアドレス(0x...) |
amountWei | 数量(BNB またはトークンの最小単位を wei で指定) |
tokenAddress | 省略可能です。ネイティブ BNB の場合は省略するか、BNB / 0x0 を指定します。それ以外の場合は ERC20 コントラクトアドレスを指定します |
- 環境変数:
PRIVATE_KEY。省略可能:BSC_RPC_URL。 - 出力:
txHash、to、amountWei、native(BNB かどうか)を含む JSON。
例:
# Send 0.1 BNB (1e17 wei)
fourmeme send 0x1234...abcd 100000000000000000
# Send 1000 units of an ERC20 (18 decimals)
fourmeme send 0x1234...abcd 1000000000000000000000 0xTokenContractAddress
EIP-8004 identity NFT(登録と照会)
EIP-8004 identity NFT:登録(ミント)と残高の照会。デフォルトのコントラクト:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432(BSC)。環境変数 8004_NFT_ADDRESS または EIP8004_NFT_ADDRESS で上書きできます。
登録:PRIVATE_KEY が必要です。ユーザーは名前(必須)、画像 URL(省略可能)、説明(省略可能)を指定します。CLI は EIP-8004 ペイロード(type、name、description、image、active、supportedTrust)を作成し、agentURI 用に data:application/json;base64,<base64> としてエンコードしてから、register(string agentURI) を呼び出します。
fourmeme 8004-register <name> [imageUrl] [description]
| 引数 | 説明 |
|---|---|
name | 必須。アイデンティティ名 |
imageUrl | 省略可能。アバター/画像の URL(外部からアクセスできる必要があります) |
description | 省略可能。説明 |
- 出力 JSON:
txHash、agentId(イベントから取得)、agentURI。
照会:読み取り専用です。アドレスが保有する 8004 NFT の数を取得します。
fourmeme 8004-balance <ownerAddress>
- 出力 JSON:
owner、balance。
例:
fourmeme 8004-register "myagent" "https://example.com/logo.png" "My agent description"
fourmeme 8004-balance 0x1234567890123456789012345678901234567890
events(TokenManager2 V2 のみ)
BSC 上の TokenCreate、TokenPurchase、TokenSale、LiquidityAdded を取得します。
fourmeme events <fromBlock> [toBlock]
最新のブロックを取得する場合は toBlock を省略します。リアルタイム購読:references/event-listening.md。
tax-info(TaxToken の手数料/税)
TaxToken(creatorType 5)のみ対応しています。
fourmeme tax-info <tokenAddress>
references/tax-token-query.md を参照してください。
エージェントのワークフロー:ランキングやイベントに基づく購入/売却
このスキルでは、トークンを見つけ、詳細を取得し、見積もりを確認して、取引を実行する一連の流れに対応します。以下はワークフローの例であり、取引の推奨ではありません:発見 → 詳細確認 → 見積もり → 実行。
- 発見(次のうち1つ以上):
- ランキング:
fourmeme token-rankings <orderBy or type>(従来の形式:Hot、TradingDesc、Time、ProgressDesc、Graduated、または VOL_DAY_1 など);応答からトークンアドレスを使用します。 - リスト:
fourmeme token-list(/public/token/search)で、--orderBy/--type、--labels/--tagなどを使って絞り込み、アドレスを取得します。 - オンチェーンイベント:
fourmeme events <fromBlock> [toBlock];TokenCreate/TokenPurchase などからトークンアドレスを解析し、「新規作成」や「最近の取引」戦略に使用します。
- ランキング:
- 詳細の取得:候補ごとに、
fourmeme token-get <address>(REST の詳細情報と取引情報)またはfourmeme token-info <address>(オンチェーン版、tokenManager、価格、オファー)を呼び出して、絞り込みや表示を行います。 - 見積もり:
fourmeme quote-buy <token> <amountWei> [fundsWei]/fourmeme quote-sell <token> <amountWei>で、推定コストまたは売却代金を取得します。 - 実行:
fourmeme buy .../fourmeme sell ...(PRIVATE_KEY が必要です)。実行前に、エージェントはユーザーの意図を確認する必要があります(例:「24時間の取引高上位5銘柄をそれぞれ0.05 BNB分購入」や「新しいトークンを0.01 BNB分自動購入」とユーザーが指定した場合)。また、資金の無断使用を避けるため、初回の自動実行前に明示的な確認を得てください。
ユーザーが「ランキングやアクティビティに基づいて購入/売却」するよう求めた場合、エージェントは、どのランキング(人気、24時間取引高、新着、卒業済みなど)を使うか、トークンごとの金額、見積もりだけを行うか実行も行うかを確認してから、適切なコマンドを実行してください。
取引(購入/売却)
- バージョン – TokenManagerHelper3 の
getTokenInfo(token)を使用します。version === 1の場合は V1 TokenManager を使用し、version === 2の場合は TokenManager2 を使用します(必要に応じて X Mode/TaxToken/AntiSniperFeeMode を確認してください)。 - 見積もり(事前計算) – TokenManagerHelper3:
- 購入:
tryBuy(token, amount, funds)– 「X トークン分購入」する場合はamount > 0を、「見積もり通貨を X 分使用」する場合はfunds > 0を指定します。 - 売却:
trySell(token, amount)。
- 購入:
- 実行 –
getTokenInfoのtokenManagerアドレスを使用し、対応するコントラクトを呼び出します:- V1:
purchaseToken/purchaseTokenAMAP、saleToken。 - V2:
buyToken/buyTokenAMAP、sellToken。売却するには、先にユーザーがERC20.approve(tokenManager, amount)を実行する必要があります。 - X Mode トークン:TokenManager2 の
buyToken(bytes args, uint256 time, bytes signature)を、エンコード済みのBuyTokenParamsとともに使用します。
- V1:
API と設定のリファレンス
- トークン詳細(REST):
GET /private/token/get?address=<token>、GET /private/token/getById?id=<requestId>(requestId は TokenCreate イベントから取得)。応答にはdata.aiCreator(エージェントが作成したトークン)が含まれる場合があります。リスト/ランキング:references/token-query-api.md。 - エージェント作成者/エージェントのウォレット:オンチェーンでは、トークンテンプレートのビット85で「エージェントが作成」を示します。BSC 上の AgentIdentifier コントラクト(
isAgent(wallet))でエージェントのウォレットを識別します。references/agent-creator-and-wallets.md と references/contract-addresses.md を参照してください。 - raisedToken:現在の raisedToken は
GET https://four.meme/meme-api/v1/public/configで取得します。作成リクエスト本文ではそのまま使用し、フィールドを変更しないでください。
参考資料
| ドキュメント | 説明 |
|---|---|
| contract-addresses.md | TokenManager / TokenManager2 / Helper3 のアドレス(BSC) |
| api-create-token.md | トークン作成 API(nonce / login / upload / create) |
| create-token-scripts.md | トークン作成スクリプトのフローと例 |
| token-tax-info.md | TaxToken の tokenTaxInfo パラメーターと制約 |
| token-query-api.md | トークン一覧 / 詳細 / ランキングの REST API |
| errors.md | buy/sell エラーコード、X Mode / TaxToken / AntiSniperFeeMode、Agent Creator |
| agent-creator-and-wallets.md | Agent Creator によって作成されたトークン、AgentIdentifier コントラクトと Agent ウォレット |
| execute-trade.md | buy/sell を実行する CLI とコントラクトの使用方法 |
| event-listening.md | TokenManager2 のイベントリスニング(V2) |
| tax-token-query.md | TaxToken のオンチェーン手数料 / 税の照会(tax-info) |
| 公式 four.meme API とコントラクト(オンライン):Protocol Integration | API ドキュメント、ABI:TokenManager、TokenManager2、Helper3、TaxToken、AgentIdentifier など |